Skip to content

Conversation

@nacezavrtanik
Copy link
Collaborator

Updated README.md with some new usage examples, but mostly updated Sphinx docs.

  • Fixed Sphinx warnings during build process.
  • Restructured the docs so they're more like a documentation page, rather than just a copy of the readme.
  • Enhanced Usage section.
  • Added an API Reference section.
  • Updated tox usage example to reflect recent(-ish) changes.

Resolves #12


NOTE: The docs on readthedocs are not up-to-date. I'd set up a publishing pipeline myself, but I'm not sure I can actually do that (I assume the project is already connected to your RTD account, or something like that). Do you think this is something you could tackle at some point? At the very least it would be nice to update the RTD docs page just to reflect the new changes.

Also updated Makefile to remove modules.rst after running sphinx-apidoc.
The modules.rst file is usually used in projects with a complex module
hierarchy, and is generated automatically with sphinx-apidoc.
In this project it is not used, which causes a sphinx warning during the
build process. (The warning is harmless, but still.)
This fixes the final Sphinx build warning (due to the file not actually
being used anywhere in the docs).
- Expanded docstring of fuzzyfinder function.
- Updated type hints to allow for iterables of non-strings.
@nacezavrtanik
Copy link
Collaborator Author

Hi! I have another PR prepared (for the highlight feature) which is based off of these changes, so it would be nice to merge this first to not make a mess out of the commit history. Hope I'm not being too pushy. 😅

Copy link
Owner

@amjith amjith left a comment

Choose a reason for hiding this comment

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

Thank you for going through this and updating it. I appreciate it.

@amjith amjith merged commit 24c9127 into amjith:main Apr 2, 2025
6 checks passed
@nacezavrtanik nacezavrtanik deleted the docs branch April 3, 2025 08:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update the readme with new features

2 participants