Docsite

[ebezzi]

Adds a docsite for cell-census, using Sphinx.

Notes:

1. Right now, the Sphinx conf and sources are in the doc folder and the artifacts are in docs. For GitHub Pages, there needs to be an index.html in docs so that folder is best reserved for it. Maybe renaming doc to docs-sphinx could be a good idea.
2. I will add a script that can be used to regenerate the docs. This should be automatic, but I wouldn't put too much effort until we finalize the hosting.

[codecov]

Codecov Report

Merging #199 (5ea001e) into main (902d4a8) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #199   +/-   ##
=======================================
  Coverage   82.43%   82.43%           
=======================================
  Files          28       28           
  Lines        1560     1560           
=======================================
  Hits         1286     1286           
  Misses        274      274           

Flag	Coverage Δ
unittests	82.43% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
.../python/cell_census/src/cell_census/_experiment.py	90.00% <ø> (ø)
...python/cell_census/src/cell_census/_get_anndata.py	100.00% <ø> (ø)
api/python/cell_census/src/cell_census/_open.py	81.63% <ø> (ø)
...on/cell_census/src/cell_census/_presence_matrix.py	100.00% <ø> (ø)
.../cell_census/src/cell_census/_release_directory.py	89.65% <ø> (ø)

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[Bento007]

Do we need to commit all of the generated files?

[ebezzi]

Do we need to commit all of the generated files?

Right now we're publishing the docs using GitHub pages on a branch, which requires the files to be in the repo. GitHub also offers another alternate workflow that, I believe, does not require the files to be checked in, but since this is just a temporary solution, I went for the simplest one. If we decide to keep GitHub Pages as the hosting solution, I think it's worth exploring.

[pablo-gar]

LGTM!