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

Doc: add reference doc for submission json schema (Infra) #872

Merged
merged 6 commits into from
Dec 7, 2023

Conversation

tang-mm
Copy link
Collaborator

@tang-mm tang-mm commented Dec 6, 2023

Description

  • added reference doc for the submission.json schema using sphinx-jsonschema extension
  • excluded the schema HTML from spelling check (property names will cause check failures)
  • cross-reference with the Test Report tutorial

Resolved issues

Resolves CHECKBOX-1043

Documentation

Preview on Readthedocs: https://canonical-checkbox.readthedocs-hosted.com/en/doc-preview/reference/submission-schema.html

Tests

In the docs/ folder, run:

make install
make run

Documentation is served at http://127.0.0.1:8000/reference/submission-schema/

@tang-mm tang-mm requested a review from a team December 6, 2023 04:29
mz2
mz2 previously approved these changes Dec 6, 2023
Copy link
Collaborator

@mz2 mz2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good!

docs/tutorial/using-checkbox/test-report.rst Outdated Show resolved Hide resolved
docs/reference/submission-schema.rst Outdated Show resolved Hide resolved
@tang-mm tang-mm merged commit 27d1974 into main Dec 7, 2023
9 checks passed
@tang-mm tang-mm deleted the doc-json-schema branch December 7, 2023 10:19
@tang-mm tang-mm restored the doc-json-schema branch December 7, 2023 10:19
@tang-mm tang-mm deleted the doc-json-schema branch December 7, 2023 10:20
binli pushed a commit to binli/checkbox that referenced this pull request Mar 22, 2024
)

* Doc: add sphinx extension for json schema

* ignore schema doc from spelling check

* update cross-references per comments

* add note in PR template for checking schema updates

* mark outdated tutorials as orphan pages

* Update .github/pull_request_template.md

Co-authored-by: Matias Piipari <[email protected]>

---------

Co-authored-by: Matias Piipari <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants