Skip to content

Landing page updates - Sv3#7

Merged
diegobilski merged 2 commits into
ApexRMS:masterfrom
kerr-hub:kr-Sv3-docs-updates
Jun 18, 2026
Merged

Landing page updates - Sv3#7
diegobilski merged 2 commits into
ApexRMS:masterfrom
kerr-hub:kr-Sv3-docs-updates

Conversation

@kerr-hub

@kerr-hub kerr-hub commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Updated required SyncroSim and package versions. Edited package description. Updated screenshots.

Summary by CodeRabbit

  • Documentation
    • Updated the Getting Started guide with the new SyncroSim 3.1.25+ installation flow (including installing from Server and selecting only stsim), plus a separate landfirevegmodels installation
    • Revised model creation steps to use From Online Template... and added reference conditions selection (CONUS & HI vs Alaska)
    • Refreshed configuration instructions and screenshots for the LANDFIRE vegetation models tabs
    • Updated the Learn more section to clarify landfirevegmodels runs on ST-Sim and refreshed linked resources
    • Updated the main landing-page requirements and refreshed the LANDFIRE team link

@kerr-hub kerr-hub requested a review from diegobilski June 16, 2026 20:08
@coderabbitai

coderabbitai Bot commented Jun 16, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 23ea4328-2dd6-46a3-8451-eb0bcf925da1

📥 Commits

Reviewing files that changed from the base of the PR and between c5e2fca and 226581e.

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

Walkthrough

Documentation updates align both docs/index.md and docs/getting_started.md with the landfirevegmodels 2.0.0 release: the minimum SyncroSim version is raised to 3.1.25, install and library-creation workflows are revised, UI configuration steps reference new datafeed tabs, screenshots are replaced, and a developer link is updated.

Changes

Documentation Update for landfirevegmodels v2.0.0

Layer / File(s) Summary
Landing page description, version requirement, and developer link
docs/index.md
Overview paragraph removes "base package" wording; minimum SyncroSim version changed from 2.2.19 to 3.1.25; LANDFIRE team link updated from conservationgateway.org to a storymaps.arcgis.com URL.
Getting started tutorial rewrite
docs/getting_started.md
Install steps updated for stsim and landfirevegmodels 2.0.0 separately; library creation switched to "File > New > From Online Template…" with named reference-condition choices; configuration steps reference "LANDFIRE vegetation models" datafeed tabs; screenshots replaced; "Learn more" section states landfirevegmodels runs on ST-Sim.
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Landing page updates - Sv3' is partially related to the changeset. It references a real aspect (landing page updates) but lacks specificity about the main substantive changes, such as version updates or package description revisions. Consider a more descriptive title such as 'Update landing page with SyncroSim 3.1.25+ requirements and LANDFIRE model descriptions' to better convey the main changes.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 2

🧹 Nitpick comments (2)
docs/getting_started.md (2)

56-56: ⚡ Quick win

Add missing comma after introductory clause.

Line 56 is missing a comma after the introductory clause before "see the SyncroSim".

✏️ Proposed comma addition
-For documentation on the SyncroSim user interface see the SyncroSim [Getting Started](http://docs.syncrosim.com/getting_started/quickstart.html){:target="_blank"} page.
+For documentation on the SyncroSim user interface, see the SyncroSim [Getting Started](http://docs.syncrosim.com/getting_started/quickstart.html){:target="_blank"} page.
🤖 Prompt for 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.

In `@docs/getting_started.md` at line 56, The introductory clause "For
documentation on the SyncroSim user interface" in the line is missing a comma
before the main clause "see the SyncroSim". Add a comma after "interface" to
properly separate the introductory phrase from the rest of the sentence, making
it read "For documentation on the SyncroSim user interface, see the SyncroSim
[Getting Started]...".

36-36: ⚡ Quick win

Add missing comma in compound sentence.

Line 36 contains a compound sentence that should include a comma before "and" to clarify the connection between independent clauses.

✏️ Proposed comma addition
-Enter a **Filename** or keep the default, select a **Folder** for your new library, and click **OK**. A download window should appear and your library will be created from an online template.
+Enter a **Filename** or keep the default, select a **Folder** for your new library, and click **OK**. A download window should appear, and your library will be created from an online template.
🤖 Prompt for 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.

In `@docs/getting_started.md` at line 36, In the sentence at line 36 of
docs/getting_started.md, add a missing comma before the "and" conjunction in the
compound sentence to properly separate the series of related actions and clarify
the connection between the independent clauses. The sentence "Enter a Filename
or keep the default, select a Folder for your new library, and click OK" should
have improved punctuation to make the list of consecutive actions clearer and
more grammatically correct.
🤖 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/getting_started.md`:
- Line 21: Add descriptive alt text attributes to all img tags in
docs/getting_started.md at lines 21, 23, 27, 44, 48, and 50 to meet
accessibility compliance and satisfy the MD045 markdown linting rule. For each
img tag, include an alt attribute that clearly describes the content or purpose
of the screenshot. Apply the same pattern consistently across all six image
tags, ensuring each alt text is descriptive and provides context about what the
image shows.
- Line 48: The image reference for `image-5` on line 48 is missing the `.png`
file extension, unlike all other image references in the file which include
`.png`. Update the src attribute in the img tag from `assets/images/image-5` to
`assets/images/image-5.png` to match the consistent file naming pattern
throughout the document and ensure the image file can be properly resolved.

---

Nitpick comments:
In `@docs/getting_started.md`:
- Line 56: The introductory clause "For documentation on the SyncroSim user
interface" in the line is missing a comma before the main clause "see the
SyncroSim". Add a comma after "interface" to properly separate the introductory
phrase from the rest of the sentence, making it read "For documentation on the
SyncroSim user interface, see the SyncroSim [Getting Started]...".
- Line 36: In the sentence at line 36 of docs/getting_started.md, add a missing
comma before the "and" conjunction in the compound sentence to properly separate
the series of related actions and clarify the connection between the independent
clauses. The sentence "Enter a Filename or keep the default, select a Folder for
your new library, and click OK" should have improved punctuation to make the
list of consecutive actions clearer and more grammatically correct.
🪄 Autofix (Beta)

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: CHILL

Plan: Pro

Run ID: 61a38d63-101a-48fa-be95-a4593292a1f9

📥 Commits

Reviewing files that changed from the base of the PR and between 3e58e71 and c5e2fca.

⛔ Files ignored due to path filters (8)
  • docs/assets/images/BurnP3Plus-screenshot-1.2.png is excluded by !**/*.png
  • docs/assets/images/BurnP3Plus-screenshot-2.1.png is excluded by !**/*.png
  • docs/assets/images/image-1.png is excluded by !**/*.png
  • docs/assets/images/image-2.png is excluded by !**/*.png
  • docs/assets/images/image-3.png is excluded by !**/*.png
  • docs/assets/images/image-4.png is excluded by !**/*.png
  • docs/assets/images/image-5.png is excluded by !**/*.png
  • docs/assets/images/image-6.png is excluded by !**/*.png
📒 Files selected for processing (2)
  • docs/getting_started.md
  • docs/index.md

Comment thread docs/getting_started.md
Open SyncroSim and select **File > Local Packages… > Install from Server**. Then, mark the check-boxes beside the **stsim** (version 4.5.3 or later).

You may need to update the **stsim** package to version 3.2.21 or later. To do so, select **File > Packages > Update...**, mark the check-box beside the **stsim** package and click **OK**.
<img align="middle" style="padding: 1px" width="500" src="assets/images/image-1.png">

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add alt text to all images for accessibility compliance.

Lines 21, 23, 27, 44, 48, and 50 include image tags without alt text, which violates accessibility best practices and fails markdown linting (MD045). All images should include descriptive alt text.

♿️ Example fix for image alt text
-<img align="middle" style="padding: 1px" width="500" src="assets/images/image-1.png">
+<img align="middle" style="padding: 1px" width="500" alt="Package installation dialog showing stsim package selection" src="assets/images/image-1.png">

Apply this pattern to all six image tags, ensuring each alt text describes the content or purpose of the screenshot.

Also applies to: 23-23, 27-27, 44-44, 48-48, 50-50

🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 21-21: Images should have alternate text (alt text)

(MD045, no-alt-text)

🤖 Prompt for 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.

In `@docs/getting_started.md` at line 21, Add descriptive alt text attributes to
all img tags in docs/getting_started.md at lines 21, 23, 27, 44, 48, and 50 to
meet accessibility compliance and satisfy the MD045 markdown linting rule. For
each img tag, include an alt attribute that clearly describes the content or
purpose of the screenshot. Apply the same pattern consistently across all six
image tags, ensuring each alt text is descriptive and provides context about
what the image shows.

Comment thread docs/getting_started.md Outdated

@diegobilski diegobilski left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

can you add the png extension suggested by coderabbit on line 48 of the getting_started? And maybe review the two commas it suggested as well

@diegobilski diegobilski self-requested a review June 18, 2026 13:12

@diegobilski diegobilski left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

looks good

@diegobilski diegobilski merged commit 57b7c34 into ApexRMS:master Jun 18, 2026
1 check 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.

2 participants