Skip to content

Define GIS terms for readers, add publication dates, and fix fact drift - #9

Merged
buschbrian merged 9 commits into
masterfrom
define-gis-terms-for-readers
Sep 1, 2026
Merged

buschbrian merged 9 commits into
masterfrom
define-gis-terms-for-readers

Conversation

@buschbrian

Copy link
Copy Markdown
Owner

Problem

The site left several general readers without support, and had three kinds
of drift between pages:

  • Several GIS terms (Wildland-Urban Interface, acre-foot, GISP) appeared
    with no explanation on first use, against the language rule that
    requires one.
  • 18 of 21 notes had no publication date anywhere: not on the page, not in
    the notes index, not in the feed.
  • The snow measurement site count was stale at 637 in the places that
    describe the application today. The live roster is 639.
  • The site framing led with cartography. The owner's day-to-day work is
    now mostly geospatial web development, and the framing did not say so.
  • Five pieces of real work (four for the City of Millcreek) were on the
    owner's LinkedIn profile and nowhere on the site.
  • The organizations and credential issuers named on the Involvement page
    had no links, and two memberships were missing.

Result

  • Defined Wildland-Urban Interface, acre-foot, and GISP (as "Certified GIS
    Professional") on first use. Confirmed the other terms from the backlog
    (hydrologic unit code, drainage area, snow water equivalent, seasonal
    percentile) already had definitions elsewhere on the site.
  • Added a publication date to 14 of the 18 undated notes: the twelve 2024
    30 Day Map Challenge notes (by challenge day, per the owner's decision to
    override the earlier no-challenge-day rule), the sidewalk and trails
    note, and the Millcreek redistricting note. Dates appear on each note
    page, in the notes index, and in the feed. Four notes still have no
    known date and stay undated on purpose.
  • Corrected the snow site count from 637 to 639 in the three places that
    describe the current application (the projects page and two spots in
    the water dashboard rebuild note), sourced from the live roster. Left
    637 where it correctly describes a past measurement or a dated system
    snapshot.
  • Reordered the site framing (home page hero, About, footer, meta
    descriptions) to lead with geospatial web development, ahead of
    cartography.
  • Logged the five undocumented projects and the permission questions they
    need answered before a note or project card can be drafted. Held the
    Nearmap widget specifically pending the owner's confirmation with the
    City of Millcreek. No new note or project card was drafted for any of
    them.
  • Linked the organizations and credential issuers on the Involvement page
    (GISAC, UGIC, SLUG, URISA, GIS Certification Institute, FAA, University
    of Utah), and added two memberships: American Association of Geographers
    and Gamma Theta Upsilon.
  • Updated sitemap.xml lastmod dates and added the missing
    western-water-dashboard-atlas entry.

Fix made during review

CONTENT-BACKLOG.md said publication dates were resolved for "13 of the
18" notes with "5 with no date," left over from before the Millcreek
redistricting note got its date in a later commit on this branch. Updated
it to 14 of 18 and 4 with no date, matching scripts/build-feed.mjs
output (21 items, 4 with no date) and the count already correct in
docs/interview-questions.md.

Checks run

  • node --check assets/js/site.js
  • npx --yes html-validate@11.6.2 "**/*.html"
  • git diff --check
  • node scripts/build-feed.mjs (feed.xml unchanged, confirms the committed
    feed matches the current dates)
  • Checked every root-relative href/src in every HTML file in the tree
    against the files that exist: no broken internal links.
  • Checked every sitemap.xml entry against the pages that exist, and
    every page against the sitemap: no gaps in either direction.
  • Checked all JSON-LD blocks in the tree for valid JSON.
  • Cross-checked every note's publication date across its own page, its
    notes-index card, and its JSON-LD datePublished: no mismatches.
  • SKIP=gitleaks pre-commit run --all-files and gitleaks git --redact --verbose . (full history): no secrets found.

No interface change, so no viewport check was needed.

🤖 Generated with Claude Code

buschbrian and others added 9 commits September 1, 2026 11:06
The house style requires an explanation for a GIS term on first use.
Three terms had no explanation where a reader first met them.

- The About page gives the full name, Certified GIS Professional, and
  states what the certification requires. The acronym appears in the
  footer of every page but was never expanded. Source: the GIS
  Certification Institute.
- The reservoir note explains an acre-foot on first use.
- The WUI note explains the Wildland-Urban Interface in its first
  sentence. The Involvement page and the notes index already did.

This closes section 4 of the content backlog. No project fact, date,
award, authorship, or source claim changed.

Checks: node --check, html-validate 11.6.2 over 28 files, git diff
--check, and a link and anchor audit of every page.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Section 1 said the site records a date for two notes. It records a date
for three. The note agentic-ai-lessons added one on 2026-08-24.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Twelve 2024 30 Day Map Challenge notes take the date of their challenge
day. The theme named in each note gives the day number. Four of the twelve
dates agree with a LinkedIn post date or with an original file name.
The sidewalk and trails note takes the date of its LinkedIn post.

The feed now reports 5 notes with no date, down from 18.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013U3nrgWnFMyZPQYPd4treP
The dashboard now reads 639 snow measurement sites. Three places on the
site said 637. Source: the published snow_sites.json, field site_count.
The figure caption keeps 637 because it reports a past measurement. The
atlas page keeps 637 inside generated data.

The redistricting note takes 2022-02-18, the publication date of the
linked StoryMap. The feed now reports 4 notes with no date.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013U3nrgWnFMyZPQYPd4treP
The site described itself as cartography and geospatial data science. The
work is now mostly application development, so the page title, the meta
descriptions, the home page heading and lede, and the footer line lead
with geospatial web development. Cartography stays, because two maps are
Esri User Conference finalists.

The home page lede also no longer joins two independent ideas with an em
dash, which the house style does not allow.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013U3nrgWnFMyZPQYPd4treP
A comparison of the LinkedIn profile against the notes directory found
five projects that the profile states and the site does not describe.
Four are municipal work. The Experience Builder widget is held until the
owner asks the City of Millcreek, as decided on 2026-08-28.

Each item needs a permission answer and an image before a draft starts,
which is the same rule that section 7 already uses.

The publication date questions now ask for the four dates that are still
missing instead of eighteen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013U3nrgWnFMyZPQYPd4treP
Every organization and issuer on the page was named with no link. A
reader could not check a credential or find a group. The certifications
table, the service headings, and the structured data now carry the
official address for each one.

Each address was opened and confirmed. The Salt Lake Area GIS Users Group
uses its Google Sites address, because slug-gis.info no longer resolves.

Two other fixes. The notes index had no og:image, so a shared link showed
no picture. The sitemap did not list the water dashboard atlas page.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013U3nrgWnFMyZPQYPd4treP
Seventeen notes now show a publication date. The date is a time element in
the meta grid on the note, and a second line on the notes index card. Four
notes still have no date and show none.

The involvement page adds the American Association of Geographers and
Gamma Theta Upsilon, with their addresses and structured data.

The snow site figure now says 639 in the roster. The roster, the daily
payload, and the atlas snapshot each hold a different number, so the site
must say which one it means. The backlog records all three.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013U3nrgWnFMyZPQYPd4treP
The redistricting note got a date in a later commit on this branch,
after the earlier count correction. The summary line still said 13
of 18 notes and 5 with no date. It is 14 of 18, and 4 with no date,
which matches the output of scripts/build-feed.mjs and the count in
docs/interview-questions.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@buschbrian
buschbrian merged commit 1ac612d into master Sep 1, 2026
5 checks passed
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