Skip to content

[main] Add Sphinx documentation (ReadTheDocs) - #78

Open
Tobiaspk wants to merge 7 commits into
mainfrom
feature/docs_init
Open

[main] Add Sphinx documentation (ReadTheDocs)#78
Tobiaspk wants to merge 7 commits into
mainfrom
feature/docs_init

Conversation

@Tobiaspk

@Tobiaspk Tobiaspk commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator

Summary

Added minimal, highly focused docs.

  • About, incl citation
  • Installation
  • Quickstart
  • API reference
  • Common Issues

Important notes:

  • API reference is handwritten / claude inferred. Autodocs is too heavy with all segger deps.
  • README was also trimmed

Expect the following changes:

closes #75

tobiaspk added 5 commits August 25, 2026 10:25
…eference

Autodoc was too fragile against segger's heavy/CUDA-only import graph (PEP 604
unions on mocked types, mocked numpy.ndarray breaking singledispatch, stale
docstrings with wrong defaults). Replaced with plain parameter tables read
directly from segger/cli/segment.py and segger/cli/export.py.
@Tobiaspk Tobiaspk changed the title Add Sphinx documentation site [main] Add Sphinx documentation (ReadTheDocs Aug 25, 2026
@Tobiaspk Tobiaspk changed the title [main] Add Sphinx documentation (ReadTheDocs [main] Add Sphinx documentation (ReadTheDocs) Aug 25, 2026

@EliHei2 EliHei2 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think, aside from the 2-3 detailed comments I noted, this looks very nice and minimalist.

Comment thread docs/api/export.rst
segger export
==============

Positional arguments select which elements to write: ``anndata``, ``transcripts``,

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe it's worth mentioning what transcripts mean --> the additional cell column (mvp!)

Comment thread docs/api/export.rst
* - ``--method``
- delaunay
- Cell-polygon method for boundaries (``delaunay`` or ``convex_hull``).
* - ``--chaikin-iterations``

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

again worth clarifying this, what it is exaclty and a reference maybe.

Comment thread docs/api/export.rst
* - ``--include-all-transcripts``
- False
- Keep every cell-assigned transcript, ignoring the similarity threshold.
* - ``--min-similarity``

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

worth mentioning highly recommended not to change.

Comment thread docs/about.rst
@@ -0,0 +1,25 @@
About

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe a contribution note would be nice, but could do later.

…ent sdata.zarr export

Filtering no longer needs a join with source transcripts now that x/y/feature_name/filtered
are inline. Also document segger export spatialdata, which adds segger's elements to an
existing SpatialData Zarr store.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation/API for the latest Segger workflow

2 participants