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

Add documentation #16

Open
balbasty opened this issue Nov 12, 2024 · 1 comment
Open

Add documentation #16

balbasty opened this issue Nov 12, 2024 · 1 comment
Labels
documentation Improvements or additions to documentation

Comments

@balbasty
Copy link
Collaborator

We should add an autodoc for the CLI, and maybe also for the internal API?

I like material-mkdocs + mkdocstrings, but open to other things.

Is there something for CLIs? I see that there's something for click and typer so maybe we should swotch to one of them (although I much much prefer the cyclopts syntax)

@balbasty balbasty added the documentation Improvements or additions to documentation label Nov 12, 2024
@kabilar
Copy link
Member

kabilar commented Nov 13, 2024

I like material-mkdocs + mkdocstrings, but open to other things.

+1

We could additionally use mike to allow users to view the documentation for different versions of the package.

Is there something for CLIs? I see that there's something for click and typer so maybe we should swotch to one of them (although I much much prefer the cyclopts syntax)

I am not familiar with these tools.

Once these API docs are deployed, we should add them to the LINC Docs under the API section.

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

No branches or pull requests

2 participants