Skip to content

docs: add "Choose your workflow" section to the README - #116

Merged
roshan2004 merged 1 commit into
mainfrom
readme-choose-your-workflow
Jun 10, 2026
Merged

docs: add "Choose your workflow" section to the README#116
roshan2004 merged 1 commit into
mainfrom
readme-choose-your-workflow

Conversation

@roshan2004

Copy link
Copy Markdown
Owner

What

Improves feature discoverability in the README by adding a compact, goal-oriented "Choose your workflow" section between the Quickstart and the full command reference. It answers "what should I run first?" by mapping an intent to a starting command and an obvious next step:

  • Look at a structure → molscope file.pdb / report
  • Sanity-check a file → qcstructure-report
  • Compare two structures → compare
  • Featurise to a table → presetsanalyze
  • Build an ML graph dataset → build_dataset / exportprepare
  • Coarse-grain → presetscoarse-grain
  • Triage docking → dock-report (+ dock-summary/dock-diverse/dock-rank)
  • Drive via an AI assistant → MCP server

Also

Surfaces two commands that existed but were missing from the command table: structure-report (protein ML-readiness) and prepare (train/val/test splits), each with an example in the CLI block. Internal anchor links (#command-line, #use-from-an-ai-assistant-mcp) verified.

Docs-only change.

Surface a goal-oriented "what should I run first?" map between the
Quickstart and the full command reference, so new users can match an
intent (look at a structure, sanity-check, compare, featurise, build a
graph dataset, coarse-grain, triage docking, drive via MCP) to a starting
command and an obvious next step.

Also adds the `structure-report` and `prepare` commands to the command
table (they existed but were undocumented there) and gives each an example.
@codecov

codecov Bot commented Jun 10, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@roshan2004
roshan2004 merged commit 0e6c15f into main Jun 10, 2026
12 checks passed
@roshan2004
roshan2004 deleted the readme-choose-your-workflow branch June 10, 2026 06:15
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