Accessible schema documentation
Accessible schema documentation.
User Stories:
As a LAVA user I'd like to learn about the bundle format (schema) so that I may understand better what information can be stored in the system.
Blueprint information
- Status:
- Complete
- Approver:
- Paul Larson
- Priority:
- Medium
- Drafter:
- Zygmunt Krynicki
- Direction:
- Approved
- Assignee:
- Zygmunt Krynicki
- Definition:
- Approved
- Series goal:
- Accepted for linaro-11.11
- Implementation:
- Implemented
- Milestone target:
- 2011.10
- Started by
- Zygmunt Krynicki
- Completed by
- Fathi Boudra
Whiteboard
[pwlars, Jul 7 2011] Should this be broken up into a few smaller ones? Perhaps start with just "document the json schema" and go from there?
[fboudra, Sep 1 2011] Acceptance criteria is missing.
[pwlars, Sep 8 2011] Acceptance criteria added.
[fboudra, Sep 8 2011] blueprint re-targeted to 2011.10.
[fboudra, Oct 10 2011] Update Headline/
[zyga Oct 21 2011] linaro-
[fboudra, 2011-10-25] Move the 4 remaining blueprints to the next cycle: accessible-
Headline: Online documentation about the results bundle format can now be viewed from linaro-
Acceptance: Result bundle format documentation can be viewed on linaro-
Work Items
Work items:
Add ReST documentation stub (linaro-
Host versioned documentation on readthedocs.org: DONE
Describe terminology used by LAVA tests, test cases, test runs, test results, test result outcome: DONE
Describe the concept of dashboard bundles as document containers (linaro-
Describe all key properties of a test result and their intended purpose: DONE
Describe backwards compatibility guarantees (linaro-
Describe migration requirements for application developers using particular document version (linaro-
Document how to ask questions about the schema, create FAQ and link it to Validation knowledge base: TODO
Provide "view schema" option based on real schema data (lava-dashboard + linaro-
Ensure that 1.3 format schema is well documented (linaro-
Provide a collection of representative examples (TBD) to be used with another blueprint for bundle viewer: DONE
Dependency tree
* Blueprints in grey have been implemented.