Skip to content

If README is not readable, nothing else will be. A linter/proofread CI for READMEs built with GitHub Actions. It's naive for now, but let's make it better together ;)

License

Notifications You must be signed in to change notification settings

tianhaoz95/readable-readme

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Readable Readme

Actions Status Actions Status

If README is not readable, nothing else will be.

Too often we find a great project, but give up 5 minutes later only because we can't get enough information from its README. I wouldn't blame the developers for the poor README readability because, first, unlike the code, there has never been a focus on README readability, and second, there is no good tools to enforce README readability.

The readable-readme project aim to build a GitHub action that checks the readability of README files and generate reports to help improve it.

Getting Started

Add the following code into your workflow steps:

- uses: actions/checkout@v1
- name: Readable Readme
  uses: tianhaoz95/[email protected]
  with:
    token: your_github_token_from_secrets

note: the token is used to post analyze report as GitHub issues.

How does it work?

strcture diagram

Also, check out the documentation.

Contribute

Any contribution is greatly appreciated. Please check out the guide for more details.