Skip to content

Conversation

@oerc0122
Copy link
Collaborator

@oerc0122 oerc0122 commented Oct 22, 2025

Description of work

  • Actually write docs on basic usage.
  • Add API doc generation as part of the sphinx build so always up-to-date

Fixes
Addresses #18

To test
Read the docs.

@oerc0122 oerc0122 self-assigned this Oct 22, 2025
@oerc0122 oerc0122 added the documentation Improvements or additions to documentation label Oct 22, 2025
@oerc0122 oerc0122 changed the title Improve docs Improve CLI docs Oct 22, 2025
@oerc0122 oerc0122 force-pushed the improve-docs branch 2 times, most recently from 1fb16a2 to 1ef3985 Compare October 22, 2025 14:27
Copy link
Collaborator

@ElliottKasoar ElliottKasoar left a comment

Choose a reason for hiding this comment

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

Generally looks great, just a few minor suggestions


::

data_collections validate examples/biosim_record.yaml
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
data_collections validate examples/biosim_record.yaml
data_collections validate data_collections_api/examples/biosim_record.yaml

So this examples works from the root of the project?

example is available). To do so, simply run::

Dump a template metadata file ready for modification to upload.
data_collections dump my_metadata
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
data_collections dump my_metadata
data_collections dump my_metadata.json

or .yml, so it works?

Comment on lines +98 to +100
``data_collections_api`` provides a method to quick-start building metadata, ``template`` will dump
an example metadata file for a particular community and data-type (though currently only a basic
example is available). To do so, simply run::
Copy link
Collaborator

Choose a reason for hiding this comment

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

Perhaps worth mentioning the format options?

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants