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

Documentation #46

Open
sjperkins opened this issue Jul 8, 2019 · 2 comments
Open

Documentation #46

sjperkins opened this issue Jul 8, 2019 · 2 comments

Comments

@sjperkins
Copy link
Member

At the moment, the documentation is in the main README.rst and is sorely out of date.

  1. The strategies are now explicitly ordered as a yaml list.
  2. The iisted commandline arguments are out of date.

To solve (1) I think each strategy and it's parameters should be documented in Restructured Text.

To solve (2) I think the user should just be instructed to tricolour --help as its always going to be difficult to keep the docs and command line args up to date.

@KshitijT
Copy link

Is the documentation available somewhere now?

@bennahugo
Copy link
Collaborator

not externally. --help should give you a reasonable idea of what options are available.

The rest is quite extensively documented in the code:
https://github.com/ska-sa/tricolour/blob/master/tricolour/flagging.py

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants