Skip to content

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

Merged
tang-mm merged 6 commits intomainfrom
doc-json-schema
Dec 7, 2023
Merged

Doc: add reference doc for submission json schema (Infra)#872
tang-mm merged 6 commits intomainfrom
doc-json-schema

Conversation

@tang-mm
Copy link
Copy Markdown
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
Copy Markdown
Contributor

@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!

Co-authored-by: Matias Piipari <matias.piipari@gmail.com>
@tang-mm tang-mm merged commit 27d1974 into main Dec 7, 2023
@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 <matias.piipari@gmail.com>

---------

Co-authored-by: Matias Piipari <matias.piipari@gmail.com>
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