Add Spinx-based documentation

[gone]

First pass of documentation using sphinx/furo

I have never done a documentation system before so I have no idea if there's a lot of easy improvements I should be doing - if you point them out to me I'm happy to improve!

I need to flush out the tips section - I will do so this week, I just wanted to get the structure in place.

I opened a read the docs instance: https://django-htmx.readthedocs.io/en/latest/ - I didn't realize it would yank the identifier, so let me know if the there's a way to transfer to you or if I should delete the instance.

I stole the precommit and spell check from debug toolbar. Let me know if there's other checks that would be helpful.

[gone]

Also I ended up adding sphinx and the theme to the requirments.ini - I don't think that's the right spot for them but I'm not sure where they should go.

[gone]

Also the contributing page - feels like a lot of projects have that but I am not sure what to put there. Do you have copy you'd like for that or should I ax it?

[adamchainz]

Thanks for getting this started. I'm going to update a bunch of stuff before merging this. Started with some review comments below, will be pushing to the PR. Please do make me an admin on Read the Docs.

[adamchainz]

Okay I’ve updated everything I could think of, rewritten the docs to make use of Sphinx features, and added a tips section covering CSRF. Please make me the owner on RtD so I can merge this.

[gone]

What's your RtD username? github id 404s :(

[adamchainz]

It's the same, with caps https://readthedocs.org/profiles/AdamChainz/

[gone]

I guess it's case sensitive then - added

[adamchainz]

Brilliant! I'm in, thanks.

[adamchainz]

Turns out to correctly set up the RtD project with the right repo and a working webhook, I needed to delete and recreate it. 🤷‍♂️

Thanks for doing the initial setup here. Expanded docs are sure to help folks get started with htmx more easily.

[gone]

Bleh annoying - learning for me, next time I'll use a testing slug