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

Review documentation for completeness and clarity #64

Open
17 tasks
RichardBruskiewich opened this issue Oct 21, 2022 · 0 comments
Open
17 tasks

Review documentation for completeness and clarity #64

RichardBruskiewich opened this issue Oct 21, 2022 · 0 comments

Comments

@RichardBruskiewich
Copy link
Collaborator

RichardBruskiewich commented Oct 21, 2022

Project documentation needs refinement:

  • Develop and deploy full mkdocs structured documentation hosted on Github.io (or readTheDocs)
  • Specific topics to review:
    • End user documentation of the semantics of the SRI Test harness unit tests and the test validation message codes
      • Maybe one or two hash indexed HTML or Markdown data dictionaries in the appropriate code repositories
      • Can this documentation be autogenerated from embedded as code comments and/or in code definition files
    • Translator resource owner guidance on configuration of KP test data or ARA configuration JSON test data
    • Running Docker (Compose)
    • Configuring use of MongoDb versus File based capture of test runs
    • General developer docs:
      • Overview of the system design
        • Relationship with Translator SmartAPI Registry
        • Pytest Engine
        • Validation logic: relationship with TRAPI and Biolink (reasoner-validator) module
        • Validation reports
        • Web Service API
        • Web Dashboard
      • Extending the system (i.e. with new knowledge graph semantic unit tests)
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

No branches or pull requests

1 participant