Skip to content

Improve CLI docs - #31

Closed
oerc0122 wants to merge 2 commits into
mainfrom
improve-docs
Closed

oerc0122 wants to merge 2 commits into
mainfrom
improve-docs

Conversation

@oerc0122

@oerc0122 oerc0122 commented Oct 22, 2025 •

Copy link
Copy Markdown
Collaborator

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

@ElliottKasoar ElliottKasoar left a comment

Copy link
Copy Markdown
Collaborator

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

Comment thread docs/source/cli.rst
Comment thread docs/source/cli.rst

::

data_collections validate examples/biosim_record.yaml

Copy link
Copy Markdown
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?

Comment thread docs/source/cli.rst
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
Copy Markdown
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 thread docs/source/cli.rst
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
Copy Markdown
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.

2 participants