DOC: suggest and/or implement improvements to our documentation

[Lucas-C]

Currently our documentation is a bit austere:
https://pdfly.readthedocs.io/en/latest/

It's built using Sphinx

It's functional, but not really attractive.

How do you think we could improve it?

There are some first random ideas:

• adopt a more attractive Sphinx theme?
• consider adopting some Sphinx extensions: https://sphinx-extensions.readthedocs.io/en/latest/ (or consider switching to mkdocs if Sphinx ecosystem is really too limited)
• add GIFs or terminal emulators (like https://github.com/Kibibit/command-lime or https://github.com/luisbraganca/fake-terminal-website) to showcase what pdfly can do?
• add an example of usage with uvx, on the homepage, in a "quickstart" section?

Do you have other ideas? 🙂

Would you like to implement some of them?

[Beautifulone0]

Hi 👋
I’d love to help improve the documentation!
I can start by experimenting with a more attractive Sphinx theme (like Furo) and maybe add a “Quickstart” section with basic examples to make it more welcoming.

Please let me know if that sounds good, or if there’s a preferred theme/style direction before I begin. 😊

[Lucas-C]

Please let me know if that sounds good, or if there’s a preferred theme/style direction before I begin. 😊

Yes, that sounds really good!

Please go on 🙏