OpenWPM
OpenWPM copied to clipboard
Move config documentation into docstrings
We could port some of our configuration documentation from Configuration.md to docstrings in config.py.
An idea would be to keep some parts of Configuration.md, such as the introductory part and the Browser profile support section, and point to the documentation that's autogenerated from the docstrings where needed.
Hello @boolean5 I would like to work on this issue. can you guide me for this?
Hey, to resolve this issue I'd like you to do the following things:
- Move the documentation from Configuration.md into the respective docstring of the attributes here
E.g. for
data_directorycurrently in Configuration.md it says "The directory into which screenshots and page dumps will be saved" so you'd write under https://github.com/mozilla/OpenWPM/blob/889b54d4295e1ad5c0da24c29a3b0ed746da33ba/openwpm/config.py#L119-L122
"""The directory into which screenshots and page dumps will be saved"""
- Figure if it's possible to link from the Configuration.md to the generated class documentation and if it isn't convert Configuration.md into Configuration.rst at which point you should be able to link to the generated class documentation.