forked from ShrRa/InterPython_Workshop_Example
-
Notifications
You must be signed in to change notification settings - Fork 0
Provide more detail in repository's README #7
Copy link
Copy link
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation
Description
The README file for lcanalyzer would be more informative to the user if a little more detail were provided regarding the functionality provided by the code. Please note that I'm not suggesting an extensive essay here, since READMEs should be concise, but answering the following questions would be beneficial:
- "LcAnalyzer is a package written in Python that allows you to inspect light curves." "Inspect" is a rather broad term which gives the impression of displaying the lightcurves for visual inspection rather than computing statistical metrics. Rephrasing this sentence to more accurately represent the package's functionality would be helpful.
- The list of main features is a good start and a really helpful summary for the user, but it is incomplete - this rather sells the project short, since the code does a lot more! This list should be expanded to better represent the available functionality.
- The README should provide guidelines on how the user should install the software at least for use on their local machine. This section should include details on how to configure the package for use, or state that no configuration is necessary.
- The README should provide information on whether user feedback is accepted (highly recommended) and the preferred way of doing so (e.g. by filing issues and pull requests).
- The README should provide a link to full documentation, such as a set of readthedocs pages. #13
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentation