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

New README.md #50

Merged
merged 13 commits into from
Sep 2, 2024
Merged

New README.md #50

merged 13 commits into from
Sep 2, 2024

Conversation

bleudev
Copy link
Member

@bleudev bleudev commented Aug 25, 2024

closes #49

Summary by Sourcery

Update the README.md to enhance its content and structure, including a project logo, feature highlights, installation instructions, contribution guidelines, and support information.

Documentation:

  • Revamp the README.md to include a project logo, badges for PyPI version, Python version, documentation, Pylint, and Black.
  • Add sections detailing key features of the ufpy package, including UDict, GitHub repository downloads, and type aliases.
  • Provide installation instructions for the latest, specific, and development versions of ufpy using pip.
  • Include a contributing guide with links to the GitHub repository and website repository for documentation contributions.
  • Add a support section with information on how to open discussions and provide feedback on GitHub.

@bleudev bleudev added the github label Aug 25, 2024
@bleudev bleudev self-assigned this Aug 25, 2024
@bleudev bleudev linked an issue Aug 25, 2024 that may be closed by this pull request
Copy link
Contributor

sourcery-ai bot commented Aug 25, 2024

Reviewer's Guide by Sourcery

This pull request significantly updates the README.md file for the ufpy project. The changes include adding a project logo, badges, and comprehensive sections on key features, installation instructions, contribution guidelines, and support information. The new README provides a more professional and informative introduction to the project, enhancing its visibility and usability for potential users and contributors.

File-Level Changes

Change Details Files
Add project logo and badges
  • Include SVG logo with light and dark mode support
  • Add badges for PyPI version, Python version, documentation, Pylint, and Black
README.md
Expand project description and key features
  • Provide a brief description of ufpy (Useful Python)
  • List key features including UDict, GitHub repository downloading, and type aliases
  • Add links to more detailed documentation for each feature
README.md
Add installation instructions
  • Include commands for installing the latest version
  • Provide instructions for installing a specific version
  • Add command for installing the development version from GitHub
README.md
Include contribution guidelines
  • Provide information on how to contribute to the main project
  • Add instructions for contributing to the documentation website
README.md
Add support section
  • Provide guidance on opening discussions for questions or problems
  • Encourage users to share suggestions and ideas through GitHub discussions
README.md

Tips
  • Trigger a new Sourcery review by commenting @sourcery-ai review on the pull request.
  • Continue your discussion with Sourcery by replying directly to review comments.
  • You can change your review settings at any time by accessing your dashboard:
    • Enable or disable the Sourcery-generated pull request summary or reviewer's guide;
    • Change the review language;
  • You can always contact us if you have any questions or feedback.

@bleudev bleudev marked this pull request as draft August 25, 2024 19:04
Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @bleudev - I've reviewed your changes - here's some feedback:

Overall Comments:

  • The Pylint badge in the README has an empty URL. Please add the correct URL to ensure the badge displays properly.
  • Consider providing a more descriptive pull request message that explains the purpose of these changes and how they relate to issue Do beatiful README.md with information about project #49.
Here's what I looked at during the review
  • 🟢 General issues: all looks good
  • 🟡 Security: 1 issue found
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟡 Documentation: 1 issue found

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.

.github/workflows/pylint.yml Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@bleudev bleudev marked this pull request as ready for review September 2, 2024 12:22
@bleudev
Copy link
Member Author

bleudev commented Sep 2, 2024

@sourcery-ai review

Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @bleudev - I've reviewed your changes and they look great!

Here's what I looked at during the review
  • 🟢 General issues: all looks good
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟡 Documentation: 1 issue found

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.

README.md Outdated Show resolved Hide resolved
Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @bleudev - I've reviewed your changes and they look great!

Here's what I looked at during the review
  • 🟢 General issues: all looks good
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟡 Documentation: 1 issue found

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.

README.md Outdated Show resolved Hide resolved
@bleudev
Copy link
Member Author

bleudev commented Sep 2, 2024

@sourcery-ai review

Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @bleudev - I've reviewed your changes - here's some feedback:

Overall Comments:

  • Consider adding a brief code example to demonstrate one of the key features, such as UDict or GitHub download functionality.
  • Please verify if the Python version badge (3.12+) accurately reflects the minimum supported Python version for the package.
Here's what I looked at during the review
  • 🟢 General issues: all looks good
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟡 Documentation: 1 issue found

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.

README.md Outdated Show resolved Hide resolved
@bleudev
Copy link
Member Author

bleudev commented Sep 2, 2024

@sourcery-ai review

Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @bleudev - I've reviewed your changes - here's some feedback:

Overall Comments:

  • Consider using standard markdown syntax instead of HTML for better compatibility across different platforms and renderers.
  • It might be beneficial to include a brief code example in the README to showcase the package's key functionality.
Here's what I looked at during the review
  • 🟢 General issues: all looks good
  • 🟢 Security: all looks good
  • 🟢 Testing: all looks good
  • 🟢 Complexity: all looks good
  • 🟡 Documentation: 1 issue found

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment to tell me if it was helpful.

README.md Outdated Show resolved Hide resolved
@bleudev
Copy link
Member Author

bleudev commented Sep 2, 2024

Ready for merge!

@bleudev bleudev merged commit 6fd573f into main Sep 2, 2024
@bleudev bleudev deleted the readme branch September 2, 2024 13:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Do beatiful README.md with information about project
1 participant