Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Reorder documentation to emphasize strongly typed data structures #976

Open
HastD opened this issue Jan 30, 2023 · 0 comments
Open

Reorder documentation to emphasize strongly typed data structures #976

HastD opened this issue Jan 30, 2023 · 0 comments

Comments

@HastD
Copy link

HastD commented Jan 30, 2023

Most JSON data that people work with in practice has a known structure, so it's suitable for parsing into a user-defined data structure—which tends to result in clearer, more robust code—rather than using serde_json::Value. However, the main README places the "Operating on untyped JSON values" section before the "Parsing JSON as strongly typed data structures", which emphasizes the untyped approach. I suggest switching the order of these sections to encourage new users to take the strongly-typed approach.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

1 participant