DecodingRaphael / unraphael

Python toolkit for unraveling image similarity with a focus on artistic practice
https://unraphael.readthedocs.io
Apache License 2.0
2 stars 1 forks source link

Documentation update #83

Closed ThijsVroegh closed 3 weeks ago

ThijsVroegh commented 1 month ago

Summary: This PR updates the project documentation of Unraphael to reflect recent changes in the streamlit pages. Key updates include:

ThijsVroegh commented 1 month ago

@stefsmeets Many thanks for all the suggestions! Yep, got into a writing mode 😅 . I included all your tips, and now the structure is hopefullly less overwhelming haha!

stefsmeets commented 1 month ago

I don't know @ThijsVroegh , I don't think this structure is all that great. It's a lot of text and I'm not sure what it is documenting. It does not link to any of the pages that we have in the application, and if I want help on any of the pages, where do I go?

Crucially, it is missing installation and usage instructions. We have these front and center in the current version of the docs: https://unraphael.readthedocs.io/en/latest/

I think this is a step backwards.

stefsmeets commented 3 weeks ago

I revised the documentation addressing some of my own comments. I also flattened the layout to make it a bit easier to navigate, and removed some of the superfluous pages.

https://unraphael.readthedocs.io/en/documentation/

I'm going to merge it now, let's pick up remaining issues in a new PR.