Skip to content

docs(tutorials): remove comparative_imbalance tutorial (redundant with user_guide)#105

Merged
Jaureguy760 merged 1 commit intodevfrom
feat/docs-delete-comparative-tutorial
Apr 19, 2026
Merged

docs(tutorials): remove comparative_imbalance tutorial (redundant with user_guide)#105
Jaureguy760 merged 1 commit intodevfrom
feat/docs-delete-comparative-tutorial

Conversation

@Jaureguy760
Copy link
Copy Markdown
Collaborator

Summary

Removes the 188-line `tutorials/comparative_imbalance.rst`. The `wasp2-analyze compare-imbalance` CLI is already fully documented in `user_guide/analysis.rst` (command, flags, usage, output interpretation); the tutorial page was redundant.

Preserved in `user_guide/analysis.rst`: a one-sentence note listing the three compare-imbalance-specific output columns (`combined_mu`, `mu1`, `mu2`) so nothing is lost.

Changes

  • Deleted: `docs/source/tutorials/comparative_imbalance.rst` (188 lines)
  • Updated 5 inbound cross-references (all `:doc:` links):
    • `index.rst` toctree
    • `user_guide/single_cell.rst`
    • `user_guide/analysis.rst` (Next Steps list)
    • `tutorials/bulk_workflow.rst` (See Also)
    • `tutorials/single_cell_workflow.rst` (inline pointer + See Also) — now points at user_guide/analysis.rst
  • Preserved: compare-imbalance output-columns note in `user_guide/analysis.rst`

Result

  • Tutorial section: 3 pages → 2 (bulk_workflow + single_cell_workflow)
  • Total docs/source: ~2,680 → ~2,490 lines (−7% this PR, ~−60% cumulative since start of day)

Test plan

  • Local Sphinx build clean (zero new warnings; grep confirms no orphan `:doc:` refs to `comparative_imbalance`)
  • CI: ruff + Rust + pytest 3.10/3.11/3.12 + CodeQL

The compare-imbalance CLI is fully documented in user_guide/analysis.rst
(command, flags, usage, output interpretation). The 188-line tutorial
page was entirely redundant — same H0/H1 formulation as statistical_models.rst,
same barcode format as user_guide/single_cell.rst, and a matplotlib volcano-plot
snippet that is generic to any p-value × effect-size pair.

Preserved in user_guide/analysis.rst: a one-sentence note listing the three
compare-imbalance-specific output columns (combined_mu, mu1, mu2) so the
output interpretation is not lost.

Updated 5 inbound :doc: references:
- index.rst toctree entry removed
- user_guide/single_cell.rst See Also line removed
- user_guide/analysis.rst Next Steps line removed
- tutorials/bulk_workflow.rst See Also line removed
- tutorials/single_cell_workflow.rst: inline pointer rewritten to point
  at user_guide/analysis.rst instead; See Also line removed

Tutorial section: 3 pages → 2 pages (bulk_workflow + single_cell_workflow).
@Jaureguy760 Jaureguy760 merged commit 125fe56 into dev Apr 19, 2026
6 checks passed
@Jaureguy760 Jaureguy760 deleted the feat/docs-delete-comparative-tutorial branch April 19, 2026 09:42
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.

1 participant