Skip to content

Improve README.md for Better Project Discoverability #166

Description

@llucax

Hello team,

To improve the onboarding experience for new users and contributors, I'd suggest enhancing the README.md file. A comprehensive README is crucial for a project's success.

Here are a few automated suggestions:

  • A 'Quick Start' section is missing. This helps users get started immediately.
  • Installation instructions or a dedicated '## Installation' section is missing.

A good README typically includes:

  • A clear project description.

  • A 'Quick Start' guide.

  • Detailed 'Installation' instructions.

  • Code examples.

  • A link to the full documentation.

  • The Supported Platform section should come before the Installation section.

  • The markdown text should not exceed 80 columns (unless there is a long link or something like that).

  • If you add an installation guide use python3 -m pip ... instead of just pip ... if you are adding pip commands. Also explain how to add the dependency in pyproject.toml. Like (adapt as needed with the correct library name and use the latest github release to take the version number of the library when pinning/as the minimum dependency):

    ```toml
    [project]
    dependencies = [
        "<the-lib> >= 1.0.0, < 2",
    ]
    ```
    > [!NOTE]
    > We recommend pinning the dependency to the latest version for programs,
    > like `"<the-lib> == 1.0.1"`, and specifying a version range spanning
    > one major version for libraries, like `"<the-lib> >= 1.0.1, < 2"`.
    > We follow [semver](https://semver.org/).

This is an automated message. Please close this issue if it's not relevant.

Activity

  1. added
    part:docsAffects the documentation
    type:enhancementNew feature or enhancement visitble to users
    on Jun 18, 2025
  2. Copilot commented on Jul 21, 2025

    Copilot
  3. assigned and unassigned on Jul 21, 2025
  4. added 4 commits that reference this issue on Dec 8, 2025
    72b783c
    ce8ece8
    275675d
    0839f8e
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

part:docsAffects the documentationtype:enhancementNew feature or enhancement visitble to users

Fields

Priority

None yet

Effort

None yet

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions