Skip to content

Streamline README and move detailed documentation to manual.md - #678

Draft
ksahlin wants to merge 4 commits into
mainfrom
readme-streamline
Draft

ksahlin wants to merge 4 commits into
mainfrom
readme-streamline

Conversation

@ksahlin

@ksahlin ksahlin commented Nov 1, 2026 •

Copy link
Copy Markdown
Owner

Shortens the README (308 → 137 lines) with a “Getting started” block up front and one Usage subsection per use case: short reads, variant calling, long reads, and abundance estimation.

Everything else moves unchanged to a new manual.md.

Depends on #677 (--exclude-alt). Long-read mapping is a TODO for now.

@marcelm
marcelm force-pushed the readme-streamline branch 3 times, most recently from e26fa3e to caf8864 Compare November 13, 2026 20:02
ksahlin and others added 4 commits November 13, 2026 21:06
Restructure the README: a "Getting started" block with
the common commands up front, short installation instructions, and a
Usage section with one subsection per use case (short-read mapping,
variant calling, long-read mapping, metagenomic abundance estimation).

Background, command-line options, read profiles, index files,
explanation of the algorithm, Python bindings and evaluation are moved
unchanged to a new manual.md, which the README links to.
@marcelm

marcelm commented Nov 13, 2026

Copy link
Copy Markdown
Collaborator

As a test, I have split up the detailed documentation (that this PR originally moved to manual.md) into more files and added configuration so that a MyST page can be built from it.

If we want to do this, the MyST documentation could be hosted on GitHub Pages or Read the Docs.

Since GitHub Pages are not activated for this repo, I created a preview in my fork: https://marcelm.github.io/strobealign/ (It looks a bit boring at the moment; we should have an image or so on the introductory page.)

This branch had an error being deployed

1 failed deployment
github-pages — 0cdf8e9d Deployed Nov 13, 2026 by marcelm via deploy #3
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.

2 participants