Add basic documentation site

[melissawm]

@SwayamInSync so sorry it took me so long!!

Here's a basic docs site setup. I haven't set up the website yet, but I can give you instructions later. Here's a preview of how the site looks like right now: https://melissawm.github.io/numpy-user-dtypes/

[juntyr]

Would it be possible to add an updated version of the release tracker table to the docs? This would be a great place to list all supported ufuncs and where we could later document e.g. the ULPs for each function

[SwayamInSync]

Thanks @melissawm

@juntyr yeah we will extend this, to add all those details

[SwayamInSync]

@ngoldbaum (didn't explored in deep yet) Would this startup setup be extendable to your work (https://unyt.readthedocs.io/en/stable/)

[ngoldbaum]

Yeah, unyt also uses sphinx. It doesn't use myst because unyt predates myst.

I would defer to Melissa's setup. Maybe look at unyt if you're interested in setting up doctesting.

[juntyr]

@SwayamInSync Should we just merge this in for 1.0?

[SwayamInSync]

I was having some plans for this actually,
@ngoldbaum please correct me if I'm wrong but can't the doc's versoning and package's versioning go independently?

[ngoldbaum]

You can but I wouldn't recommend it. It's much better IMO for doc changes to happen at the same time as code changes.

My recommendation is to merge this, set up a docs site on github pages or readthedocs, and iterate from there.

[SwayamInSync]

You can but I wouldn't recommend it. It's much better IMO for doc changes to happen at the same time as code changes.

My recommendation is to merge this, set up a docs site on github pages or readthedocs, and iterate from there.

Sure then, I'll resolve its conflict and merge in after #246