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 automatically generated API to documentation in https://ruyaml.readthedocs.io #52

Open
mauvilsa opened this issue May 10, 2021 · 1 comment
Labels
docs This issue/PR relates to or includes documentation.

Comments

@mauvilsa
Copy link

It would be very useful if the API automatically generated using sphinx's autodoc is included in the documentation of readthedocs. If I understand correctly this was actually the plan (#1 (comment)). Still I think it is good to have a github issue requesting this.

Just for reference. I am considering the use of ruyaml to generate a yaml with comments (omni-us/jsonargparse#52). But the methods that can be used to add comments are not documented. There is only one example in the documentation which only mentions yaml_add_eol_comment but there is no way to know what other methods there are or the parameters they receive and their descriptions.

@gdubicki gdubicki added the docs This issue/PR relates to or includes documentation. label Dec 7, 2021
@funkyfuture
Copy link

indeed i was very suprised that this (or rather the origin) so popular package has such a, excuse my dutch, shitty documentation. it would be most helpful not only to add API docs, but also to get rid of all the contents with elaborations about a previous API and whatnot anecdotes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs This issue/PR relates to or includes documentation.
Projects
None yet
Development

No branches or pull requests

3 participants