[python] Reduce warnings during doc builds + fix broken links (#1162)

* Add autosummary to gitignore

* Move unused docs, and fix line lengths

* Fix some links

* Remove soma.rst + setup.rst as @ebezzi says they are outdated

Author: ivirshup

.gitignore

@@ -73,6 +73,7 @@ instance/
 
 # Sphinx documentation
 docs/_build/
+_autosummary
 
 # PyBuilder
 target/

docs/README.md dev-docs/README.md

@@ -1,5 +1,5 @@
 What's new?
-==========
+===========
 
 2023
 ----------

docs/cellxgene_census_mirroring.md dev-docs/cellxgene_census_mirroring.md

@@ -1,9 +1,9 @@
 Python tutorials
-==========
+================
 
 
 Exporting data
-----------
+--------------
 
 Learn how to stream the single-cell data and metadata from Census into your machine.
 
@@ -16,7 +16,7 @@ Learn how to stream the single-cell data and metadata from Census into your mach
     notebooks/api_demo/census_gget_demo.ipynb
 
 [NEW! 🚀] Using integrated embeddings and models
-----------
+------------------------------------------------
 
 Tutorials that show you how to retrieve pre-calculated Census embeddings and use their associated models for your workflows.
 
@@ -44,23 +44,22 @@ Exploring human biology with Census embeddings.
     notebooks/analysis_demo/comp_bio_embedding_exploration.ipynb
 
 Understanding Census data
-----------
+--------------------------
 
 Gain a better understanding on the nature of the Census data and how it's organized.
 
 .. toctree::
     :maxdepth: 1
 
-    notebooks/analysis_demo/census_duplicated_cells.ipynb
+    notebooks/api_demo/census_duplicated_cells.ipynb
     notebooks/analysis_demo/comp_bio_census_info.ipynb
-    notebooks/analysis_demo/census_summary_cell_counts.ipynb
     notebooks/analysis_demo/comp_bio_explore_and_load_lung_data.ipynb
     notebooks/api_demo/census_datasets.ipynb
     notebooks/api_demo/census_dataset_presence.ipynb
     notebooks/api_demo/census_summary_cell_counts.ipynb
 
 Analyzing Census data
-----------
+---------------------
 
 A few examples of relevant analysis pipelines with Census data.
 
@@ -72,7 +71,7 @@ A few examples of relevant analysis pipelines with Census data.
     notebooks/analysis_demo/comp_bio_normalizing_full_gene_sequencing.ipynb
 
 Scalable computing
-----------
+------------------
 
 Demonstrations of memory-efficient compute workflows that leverage the streaming capabilities of Census.
 
@@ -81,10 +80,10 @@ Demonstrations of memory-efficient compute workflows that leverage the streaming
 
     notebooks/experimental/highly_variable_genes.ipynb
     notebooks/experimental/mean_variance.ipynb
-    notebooks/analysis_demo/census_compute_over_X.ipynb
+    notebooks/api_demo/census_compute_over_X.ipynb
 
 Scalable machine learning
-----------
+-------------------------
 
 Learn about features to do data modeling directly from Census into machine learning toolkits.