docs: Rewrite docs

[rschristian]

No description provided.

[rschristian]

@Munawwar @donkeyDau As I've been chatting to the both of you about these docs, if either of you have a couple minutes to donate to skim this, I'd greatly appreciate it. Let me know if I missed anything, anything's unclear, etc.

There are some awkward parts of the API that I have (loose) plans to fix, so admittedly there might still be some oddities, but hopefully these docs at least let you build something with the lib.

Format still tbd, I might rearrange some stuff.

[donkeyDau]

🙇 Thanks a lot. This increases understanding and insight into the package. Please check if some of my suggestions suit you.

[Munawwar]

Final missing thing here is a note on how to render a URL from server side. I don't know if there is hard dependency on global location object, but as you mentioned, your experience is that stubbing location object is more reliable than any library level interfaces, as other libraries could assume it's existence. I think it is a critical bit to know and having that snippet to stub location would be useful.

[rschristian]

Yeah was going to add that little helper I showed in a separate PR, then figure out how to add that to the docs here.

There's technically not a hard dependency on location, but the current implementation is a tad flawed and honestly stubbing location is just a far more robust solution, so I'd like to walk back on that flawed impl.