[NewGraphEnvironment]

Fixes #105

What changed

• README rewritten in the order the README convention sets: hex sticker with alt text, lifecycle badge, tagline, a three-sentence opening, a map, installation, an example, Learn more, Ecosystem, Data and methods, Citation and license. The opening describes what drift does: it fetches land cover, compares it between two dates and across the annual series, and turns the change into maps, tables and polygons. Checking change (Sentinel-2, Esri Wayback, accuracy sampling) and overlay tags get one sentence. The issue's "what it does by stage" list is folded into the opening rather than added as a section, following the direction to keep the detail light.
• README map: man/figures/readme-change.png, built by data-raw/readme_figure.R from the bundled Neexdzii Kwa rasters. It shows 2017→2023 change in four groups (trees to rangeland, crops to rangeland, became water, other) at 50% opacity over muted Esri World Imagery. Colours and opacity come from inst/cartography/drift_readme.csv.
  • The published stac_floodplains_bc scheme colours each patch by the class it became. Rendered over imagery, it nearly hid the change, so the README keeps its own groups.
• Example: a bundled-data run of dft_rast_classify() and dft_rast_transition(), shown with the output it really prints. It needs no network.
• All four documents are listed: two vignettes and two articles.
• Docs URL is now https://www.newgraphenvironment.com/drift/ in README, DESCRIPTION (still the second URL, so inst/CITATION keeps the repo URL) and _pkgdown.yml. newgraphenvironment.github.io/drift/ redirects there.
  • With a /drift/ path, pkgdown writes no CNAME.
  • link, flooded, gq and fresh still use github.io in DESCRIPTION, so drift now differs from them.
• DESCRIPTION Description now matches the opening and ends "Under active development." The Title is kept. man/drift-package.Rd is regenerated.
• CITATION.cff workflow passes authors_roles = c("aut", "cre", "cph"), so New Graph Environment Ltd. stays an author when the bot regenerates the file after merge.
• pkgdown reference index is grouped into eight sections by purpose. Each of the 33 exports appears exactly once, and check_pkgdown() is clean.

Checks

• Tests: [ FAIL 0 | WARN 0 | SKIP 19 | PASS 1709 ].
• All 24 README links return 200. Every function the README names is exported.
• The map re-renders byte-identical from a git archive HEAD copy. The PNG is RGB with no alpha channel, and the cartography self-review was done at 700 px.
• /code-check branch: 4 rounds (2, 0, 2, 0 findings): 3 fixed, 1 accepted (citation("drift") and CITATION.cff list authors and URL differently; both valid), none inside an earlier fix. Fixes: the caption's "of 123 ha" read as the floodplain's area (the outline is 104 ha; 123 ha is the cells it touches); "smaller transitions" was false for single transitions; a script comment said fourteen colours where ten are change. Plan review folded in beforehand (attribute wording, gdalcubes note, ecosystem table, reference grouping).
• README length: 269 → 727 words (wc -w). The prose is short. Most of the growth is the ecosystem table, the example code and its output, and alt text.

After merge

• Set the GitHub About and homepage to match the tagline:

  gh repo edit NewGraphEnvironment/drift --description "Detecting riparian and inland floodplain transitions: track land cover change within floodplains over time" --homepage https://www.newgraphenvironment.com/drift/
  

• soul#446 is a 404 link to a drift vignette in the shared cartography convention. It was found here and is fixed at its source.

Relates to NewGraphEnvironment/sred-2025-2026#16

🤖 Generated with Claude Code

https://claude.ai/code/session_01PRhUJsuKABLfpBGktPoiBN