Skip to content

docs: link hero screenshots and move media to assets.geolibre.app - #1792

Merged
giswqs merged 7 commits into
mainfrom
docs/hero-second-screenshot
Aug 9, 2026
Merged

docs: link hero screenshots and move media to assets.geolibre.app#1792
giswqs merged 7 commits into
mainfrom
docs/hero-second-screenshot

Conversation

@giswqs

@giswqs giswqs commented Aug 9, 2026

Copy link
Copy Markdown
Member

Summary

  • Show a second screenshot in the landing-page hero (3D extruded Manhattan buildings with subway layers and a legend) next to the existing map view, and link each hero image to the live shared project it shows.
  • Move every README screenshot and the Time Slider animation off files.opengeos.org onto the project's own asset host: images under assets.geolibre.app/images, the GIF and WebM under assets.geolibre.app/demos.
  • Wrap the hero media in a grid so the two figures stack with consistent spacing.

Test plan

  • mkdocs serve and confirm both hero images load, are spaced evenly, and open their shared maps when clicked.
  • Check the hero at narrow viewport widths (mobile) and in both light and dark theme.
  • Confirm every image and the animation render on the rendered README, and that no reference to the old host remains.

Summary by CodeRabbit

  • New Features
    • Added a linked NYC buildings visualization alongside the existing GeoLibre demo in the hero section.
  • Style
    • Updated the hero media layout to display multiple visual examples in a grid.
    • Refined figure spacing and presentation for consistent media display.
  • Documentation
    • Updated demo, basemap, and geoprocessing image links.
    • Clarified asset-hosting guidance for sample datasets and new media.
    • Streamlined the Whitebox geoprocessing description.
    • Removed the network analysis and geocoding feature card.

The hero showed a single map view. A 3D building example alongside it
gives a fuller first impression of what the app can render. Both images
now come from the assets.geolibre.app host.
Copilot AI lite review requested due to automatic review settings August 9, 2026 13:17

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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.

@coderabbitai

coderabbitai Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 00b6dba6-5ecb-4775-a413-992ae7aa38a2

📥 Commits

Reviewing files that changed from the base of the PR and between f639c87 and 89fe4be.

📒 Files selected for processing (5)
  • docs/contributing.md
  • docs/demos.md
  • docs/user-guide/processing.md
  • packaging/linux/org.geolibre.desktop.metainfo.xml
  • scripts/render-linux-metainfo.sh

📝 Walkthrough

Walkthrough

The homepage now shows linked GeoLibre and NYC buildings figures. CSS places them in a grid. Documentation media uses assets.geolibre.app. Contributor guidance and Linux metadata use updated asset references. Homepage feature text removes conversion and network analysis details.

Changes

Documentation and asset references

Layer / File(s) Summary
Homepage media and feature content
docs/index.md, docs/stylesheets/extra.css
The homepage adds two linked hero figures, applies grid styling, removes Whitebox conversion details, and removes the network analysis and geocoding card.
Documentation asset host migration
README.md, docs/demos.md, docs/user-guide/processing.md
Demo, planetary basemap, and Whitebox media links now use assets.geolibre.app.
Asset guidance and Linux metadata
docs/contributing.md, packaging/linux/org.geolibre.desktop.metainfo.xml, scripts/render-linux-metainfo.sh
Contributor guidance separates sample datasets from new assets. Linux screenshot references use the new asset host.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

Poem

A rabbit hops through figures bright,
NYC buildings join the light.
Assets move to hosts anew,
Feature text becomes more true.
The documentation shines in view.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the hero screenshot links and the media migration to assets.geolibre.app.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/hero-second-screenshot

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

Code review

Reviewed the two changed files (docs/index.md, docs/stylesheets/extra.css) — a docs-only change adding a second hero image and restructuring .hero__media from a single <figure> into a <div> wrapping two <figure> elements, styled as a single-column CSS grid.

Bugs: None found. The .hero__media img descendant selector still matches the nested <img> tags correctly after the markup restructure, and the new .hero__media figure { margin: 0; } rule correctly neutralizes the browser's default <figure> margin so the grid gap is the only spacing between the two images (medium-high confidence this is correct and intentional).

Security: None found. No injected content, scripts, or unsanitized input; just two static <img> tags with descriptive alt text.

Performance: No issues — this only adds one additional static image reference.

Quality: Minor, non-blocking observation (low confidence, not worth blocking on): the PR switches both hero images to https://assets.geolibre.app/images/..., but other docs pages (comparison.md, demos.md, contributing.md, README.md, tutorial pages) still reference files.opengeos.org. That's outside this PR's stated scope ("Serve both hero images..."), so likely fine, but worth confirming the migration to assets.geolibre.app is intentionally scoped to just the hero for now rather than an oversight.

CLAUDE.md: Not applicable — the CSP/tile-host allowlist convention in CLAUDE.md concerns the Tauri desktop app's map/tile hosts, not the mkdocs documentation site, so no allowlist update is needed for the new image host.

No inline comments posted — the change is small, well-scoped, and I didn't find anything rising to reportable severity.

The screenshot is a real published project, so clicking it should open
the live map rather than being a static image.
@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

🔍 Cloudflare PR preview

Item Value
Site https://9df35812.geolibre-preview.pages.dev
Demo app https://9df35812.geolibre-preview.pages.dev/demo/
Commit 89fe4be

Matches the NYC screenshot next to it, so both hero images open the live
project they show.
@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

🔍 GitHub Pages PR preview

Item Value
Site https://opengeos.org/pages-preview/GeoLibre/pr-1792/
Demo app https://opengeos.org/pages-preview/GeoLibre/pr-1792/demo/
Commit 89fe4be

Note

GitHub Pages built this preview successfully, but its serving edge returned HTTP 403 when checked. The links may still be propagating.

Comment thread docs/index.md
</figure>
<figure>
<a href="https://share.geolibre.app/giswqs/nyc-buildings-and-subways" title="Open the New York City buildings and subways map">
<img src="https://assets.geolibre.app/images/nyc-buildings.webp" alt="Manhattan buildings extruded in 3D and colored by construction era, with MTA subway lines and stations and an auto-generated legend">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Low confidence, quality/process: nyc-buildings.webp is a new addition under assets.geolibre.app/images/ (the existing copy referenced elsewhere in the docs, e.g. docs/demos.md, still lives at files.opengeos.org/nyc-buildings.webp). Per docs/contributing.md, publishing to assets.geolibre.app requires pushing the file to the separate opengeos/geolibre-assets repo first. Since zensical build --strict only validates internal links/nav, not external image URLs, if that mirror hasn't been pushed yet this ships with a silently broken hero image. Worth confirming the asset is live (the PR's own test-plan checkbox for this is still unchecked) before merging.

Comment thread docs/index.md
Comment on lines +26 to +35
<figure>
<a href="https://share.geolibre.app/giswqs/3d-tiles" title="Open the 3D Tiles map">
<img src="https://assets.geolibre.app/images/GeoLibre-demo.webp" alt="GeoLibre map interface showing the GIS workspace">
</a>
</figure>
<figure>
<a href="https://share.geolibre.app/giswqs/nyc-buildings-and-subways" title="Open the New York City buildings and subways map">
<img src="https://assets.geolibre.app/images/nyc-buildings.webp" alt="Manhattan buildings extruded in 3D and colored by construction era, with MTA subway lines and stations and an auto-generated legend">
</a>
</figure>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Very low confidence, quality/a11y nit: both hero images are now wrapped in <a> links with a title attribute describing the destination ("Open the 3D Tiles map" / "Open the New York City buildings and subways map"), but no visible/link text. Screen readers typically derive a link's accessible name from the child <img alt> (which describes the image content, e.g. "GeoLibre map interface showing the GIS workspace") rather than reliably announcing title. Consider an aria-label on the <a> (or reusing the title text as the accessible name) if the destination context should be conveyed to AT users — optional, not blocking.

@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

Code review

This is a small, low-risk docs/CSS change (hero section now shows two screenshots, images re-hosted to assets.geolibre.app, CSS updated to a stacked-figure grid). No logic bugs found; the CSS grid refactor is consistent with the .hero responsive breakpoints already in extra.css, and the new asset host matches the convention documented in docs/contributing.md.

Bugs: None found.

Security: None found. No secrets, injection, or unsafe input handling — this is static markdown/CSS.

Performance: None found. Two images instead of one is a negligible cost for a landing page.

Quality:

  • Low confidence: nyc-buildings.webp appears to be a new file under assets.geolibre.app/images/ (the existing copy elsewhere in the docs still lives at files.opengeos.org). Per the project's asset-publishing convention, that requires a prior push to the separate opengeos/geolibre-assets repo, and zensical build --strict won't catch a missing external image. Worth confirming the asset is actually live before merge — the PR's own test-plan checkbox for this is still unchecked.
  • Very low confidence (a11y nit): the new <a title="..."> wrappers around each hero image rely on title to convey link purpose, but the accessible name screen readers use typically falls back to the child <img alt> (image description) rather than title. Not blocking — just flagging as an option to add aria-label if link context matters for AT users.

CLAUDE.md: No violations. The image-hosting change follows docs/contributing.md's documented convention of referencing assets.geolibre.app published paths rather than GitHub blob/raw URLs, and no other guarded conventions (Tauri CSP, i18n, RTL logical classes, etc.) apply to this docs-only change.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/index.md`:
- Line 70: Revise the toolbox description around the “1,000+ geoprocessing
tools” claim to distinguish tools that run client-side in WebAssembly from
vector and raster operations requiring GeoPandas or rasterio sidecars. Remove
the blanket “no Python sidecar” and universal platform-support claims unless
they are true for every operation, while preserving the documented
supported-platform details.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 48af99d9-cf48-44c9-a8a4-ccd8f997b286

📥 Commits

Reviewing files that changed from the base of the PR and between 5fd5f8b and 092faaa.

📒 Files selected for processing (1)
  • docs/index.md

Comment thread docs/index.md
Moves the README screenshots and the Time Slider animation off
files.opengeos.org onto the project's own asset host, matching the
landing page. Images live under /images, the GIF and WebM under /demos.
@giswqs giswqs changed the title docs(home): add a second hero screenshot docs: link hero screenshots and move media to assets.geolibre.app Aug 9, 2026
Covers the references the README pass missed: the demos gallery, the
Whitebox screenshot, and the AppStream screenshot in both the metainfo
and the script that renders it. Nothing in the repo points at the old
host now, so the contributing note no longer lists it.
Comment thread docs/index.md
<div class="hero__media">
<figure>
<a href="https://share.geolibre.app/giswqs/3d-tiles" title="Open the 3D Tiles map">
<img src="https://assets.geolibre.app/images/GeoLibre-demo.webp" alt="GeoLibre map interface showing the GIS workspace">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This migrates GeoLibre-demo.webp/nyc-buildings.webp to assets.geolibre.app, matching the README change in this PR, but the identical images are also embedded in docs/demos.md and docs/user-guide/processing.md (whitebox.webp), which still point at files.opengeos.org and weren't touched here. That leaves the same pictures served from two different hosts across the docs site, and those other pages will break together if files.opengeos.org is ever retired. Might be worth a follow-up to finish the migration there.

Confidence: medium.

@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

Code review

Bugs: None found. All URL replacements (files.opengeos.orgassets.geolibre.app/images/... or .../demos/...) are complete and internally consistent — verified no remaining files.opengeos.org references anywhere in the tree, and confirmed the images//demos/ path split matches the convention already documented in docs/contributing.md's asset table.

Security: None found. Doc-only change; no user input handling, no injected content, no secrets.

Performance: None found. Not applicable to this change.

Quality:

  • Low confidence: the docs/index.md hero now stacks two images in .hero__media (display: grid with no explicit grid-template-columns, so it defaults to a single implicit column). This matches the PR description's stated intent ("stack with consistent spacing"), so it's very likely intentional rather than a mistake — but it does mean the media column will be roughly twice as tall as the content column on wide viewports where .hero becomes two columns (@media (min-width: 76.25em)). Worth a visual check since the PR's own test plan checkboxes for viewport/theme verification are unchecked.
  • Low confidence: docs/index.md's "1,000+ geoprocessing tools" card drops the sentence describing the Conversion menu (GeoParquet/FlatGeobuf/PMTiles/COG export) entirely rather than relocating it; conversion capability is now only implied by the word "conversion" in the tool-category list. This looks like an intentional trim (matches CodeRabbit's summary "streamlined... description"), but it does mean that capability loses its own explanation on the landing page.

CLAUDE.md: No violations. The change stays within docs/README/packaging scope, keeps scripts/render-linux-metainfo.sh and packaging/linux/org.geolibre.desktop.metainfo.xml in sync as required, and doesn't touch any of the mirrored-constant or generated-catalog files the guidelines call out.

No inline comments posted — nothing met the bar for a specific, actionable finding.

@giswqs
giswqs merged commit 07cc360 into main Aug 9, 2026
11 checks passed
@giswqs
giswqs deleted the docs/hero-second-screenshot branch August 9, 2026 13:40
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