Diving into this repository to fully understand its contents and purpose would be quite time-consuming. So I've leveraged Claude Code to analyse the codebase and generate comprehensive documentation - saving time while hopefully providing accurate insights for potential contributors and self-hosters. Please don't judge my laziness (or genius) too harshly 😆 !

Whilst I understand that documentation often takes a backseat when more urgent priorities arise, I rather avoid spending hours reverse-engineering the code myself (and likely making mistakes and misunderstandings), I thought having Claude create the initial documentation would be both more efficient and potentially more accurate (he says hopefully!). After all, reviewing and improving existing documentation is significantly easier than creating it from scratch.

I welcome the Octo STS maintainers to suggest as many commit suggestions to this PR as needed. My primary goal is to provide thorough documentation to get folks more aware of what it does and how. As I've mentioned elsewhere, I'm genuinely passionate about this project and want to see it widely adopted, but reducing barriers to entry is essential for that to happen - and clear documentation is the first critical step.

I shall initially mark this as a draft to gauge peoples thoughts. However, if it gets closer to being mergeable, I'm more than happy for a maintainer to mark it as ready for review.