Document how to deserialize and serialize XML with namespaces using serde

Open
#803 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
44/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
rust
Domain
documentation

Research direction

Gather the existing namespace examples in the documentation and start by locating how quick-xml currently shows serde serialization and deserialization. Document both cases described in the issue: namespaces declared on the root element and namespaces declared inside child elements, including xsi:... attributes. Done means the documentation explains both cases with clear examples.

Written by the indexing model from the issue text.

Description

documentation namespaces serde

There's a few examples here and there, I'd like to gather them to documentation. There's 2 cases with using namespaces used differently: When all namespaces are defined as attributes of a root element of the document, and namespaces defined inside child element.

Maybe it would be obvious to define them, but it would be better, when these examples would be documented properly, including xsi:... attributes

Dominant language
Rust
Stars
1.6k
Forks
299
Avg merge
2d 4h
Merged PRs (30d)
9

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from tafia/quick-xml

All issues in tafia/quick-xml

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.