Skip to content

Correct the stale parts of the README - #12

Open
bmesuere wants to merge 1 commit into
phase1/ci-and-test-fixfrom
docs/readme-corrections
Open

Correct the stale parts of the README#12
bmesuere wants to merge 1 commit into
phase1/ci-and-test-fixfrom
docs/readme-corrections

Conversation

@bmesuere

@bmesuere bmesuere commented Aug 18, 2026

Copy link
Copy Markdown
Member

Four things in the README that no longer hold. Each was checked against the current tooling rather than read off the page.

Claim Reality
"should work on 1.35 and higher" Real floor is 1.88, set by the icu crates via attohttpc -> url -> idna. The MSRV job in #10 builds against exactly this.
No mention of crates.io Published since 2019 with 6,209 downloads, and cargo install umgap was undocumented. It installs only the binary and none of scripts/, so the README now says the clone is still needed for the preconfigured pipelines.
[metagenomics casestudy] -> /clidocs/casestudies/metagenomics Not a route on the website. It returns 200 only because the SPA answers every path. The case study lives at /umgap/casestudies.
"NOT YET INTEGRATED - umgap-visualize.sh output.fa output.html" The script works and takes -w, writing to stdout. The command shown was never its interface.

The gene predictor is handled separately in #13, which swaps FragGeneScan++ for FragGeneScanRs. The two touch disjoint parts of the README and merge cleanly in either order; I verified that locally.

Worth knowing

cargo install umgap today gets 1.1.0, which still has the joinkmers bug from #8. Either hold this until 1.1.1 is published, or merge and accept a short window.

umgap-visualize.sh -t fails on macOS with find: -printf: unknown primary or operator, a GNU-only flag. Not touched here.

Copilot AI lite review requested due to automatic review settings August 18, 2026 12:46

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@bmesuere bmesuere changed the title Correct the stale parts of the README Use FragGeneScanRs, and correct the stale parts of the README Aug 18, 2026
@bmesuere
bmesuere force-pushed the docs/readme-corrections branch from 78648a4 to 4a98e59 Compare August 18, 2026 13:00
@bmesuere
bmesuere changed the base branch from master to phase1/ci-and-test-fix August 18, 2026 13:00
- The minimum Rust version was given as 1.35. The real floor is 1.88, set by
  the icu crates that come in through attohttpc -> url -> idna.

- The crate was never mentioned, even though it has been on crates.io since
  2019 with over 6000 downloads. Added `cargo install umgap`, noting that it
  installs only the binary: the pipeline scripts are not part of the published
  crate, so the clone is still needed for those.

- The metagenomics case study link pointed at /clidocs/casestudies/metagenomics,
  which is not a route on the website. It lives at /umgap/casestudies.

- The visualisation step was marked NOT YET INTEGRATED and showed a command
  that does not match the script's interface. It takes -w and writes to
  standard output.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@bmesuere
bmesuere force-pushed the docs/readme-corrections branch from 4a98e59 to 23a995c Compare August 18, 2026 13:02
@bmesuere bmesuere changed the title Use FragGeneScanRs, and correct the stale parts of the README Correct the stale parts of the README Aug 18, 2026
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