ruyaml icon indicating copy to clipboard operation
ruyaml copied to clipboard

Add automatically generated API to documentation in https://ruyaml.readthedocs.io

Open mauvilsa opened this issue 4 years ago • 1 comments

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 (https://github.com/pycontribs/ruyaml/issues/1#issuecomment-716967334). 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 (https://github.com/omni-us/jsonargparse/issues/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.

mauvilsa avatar May 10 '21 16:05 mauvilsa

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.

funkyfuture avatar Sep 18 '22 09:09 funkyfuture