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.

Sign up for GitHub

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

Jump to bottom

Document JsonDocCk and checkmissingitems.py #100515

Open
aDotInTheVoid opened this issue Aug 14, 2022 · 0 comments
Open

Document JsonDocCk and checkmissingitems.py #100515

aDotInTheVoid opened this issue Aug 14, 2022 · 0 comments
Assignees
@aDotInTheVoid
Labels
A-contributor-roadblock Area: Makes things more difficult for new contributors to rust itself A-rustdoc-json Area: Rustdoc JSON backend T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue.

Comments

@aDotInTheVoid
Copy link
Member

aDotInTheVoid commented Aug 14, 2022 •
edited
Loading

The testing infra for rustdoc-json isn't well documented.

It would be good to write down how it works, as well as some tips for developing tests.

Things to documents

  • jsondocck commands
  • JSONPath usage
  • Variables
  • Semantics of jsonpath multiple selections, and when to use [*]
  • no_core for smaller output
  • selecting on doc to simplify queries.
  • my oj format script
  • only rerunning jsondocck (not x.py)
  • Modifying checkmissingitems.py after changing schema

@rustbot claim

@rustbot modify labels: +A-rustdoc-json +T-rustdoc +A-contributor-roadblock
@rustbot rustbot added A-contributor-roadblock Area: Makes things more difficult for new contributors to rust itself A-rustdoc-json Area: Rustdoc JSON backend T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue. labels Aug 14, 2022
@aDotInTheVoid aDotInTheVoid mentioned this issue Apr 14, 2023
Merged
jyn514 added a commit to jyn514/rust that referenced this issue Apr 26, 2023
@jyn514
Rollup merge of rust-lang#110329 - aDotInTheVoid:json-inline-again, r…
a1d4718 
…=jyn514

Improve tests for rust-lang#110138

These should live in rustdoc-json, not rustdoc-ui, so we can run assertions, and not just check there's no ICE

CC rust-lang#100515, as we never document this suite

r? rustdoc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@aDotInTheVoid aDotInTheVoid

Labels
A-contributor-roadblock Area: Makes things more difficult for new contributors to rust itself A-rustdoc-json Area: Rustdoc JSON backend T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue.
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@aDotInTheVoid @rustbot