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

Optimize README #27

Open
16 tasks
timothyb0912 opened this issue Nov 14, 2020 · 0 comments
Open
16 tasks

Optimize README #27

timothyb0912 opened this issue Nov 14, 2020 · 0 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@timothyb0912
Copy link
Owner

timothyb0912 commented Nov 14, 2020

What

The README should be improved in numerous ways:

  • add a package logo
  • add a badge for the code-style being black
  • include a sentence in the long description that ponits out how checkrs is a package for attaching particular views to one's simulated and observed data, for comparison purposes. It visualizes one's data and a model's predictive distribution of that data.
  • include a links section
    • provide a link to relevant project documents
      • contribution guidelines,
      • development and release notes,
    • point readers to where they can get support (github issues)
    • point out similar projects and effots. "Credits, inspiration, alternatives"
  • include a license section that links to the license and states what the license is (MIT, BSD-3, etc.)
  • include a features section describing what differentiates this package from alternatives
  • include a section showing how to run the tests: pytest .
  • include a section linking to the project roadmap (as a separate file).
  • include a runnable example in the repo and link to it in the README
  • state caveats and limitations early and clearly (e.g. plotting lots of data with altair in notebooks).
  • ensure examples uses python code syntax highlighting
  • ensure the layout practices cognitive funneling (i.e. be most useful then get more specific)
  • ensure the README is not too long

See the following resources as inspiration for how to create good READMEs:

@timothyb0912 timothyb0912 added the documentation Improvements or additions to documentation label Nov 14, 2020
@timothyb0912 timothyb0912 self-assigned this Nov 14, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant