Update getting started page #1449
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR restructures the “Getting Started” section into a clear four‐step workflow, replaces legacy introductory pages with new step‐based content, and updates navigation links and weights to align with the new structure.
- Rework getting started into four sequential steps (1–4) with renamed pages and updated titles/aliases
- Remove old “the-things-stack-basics” and “lorawan-basics” pages in favor of new step-based guides
- Update navigation (weights, aliases, links) in theme and cloud concept pages
Reviewed Changes
Copilot reviewed 16 out of 60 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| doc/themes/the-things-stack/layouts/index.html | Point “Set up your first LoRaWAN® network” link to step 2 |
| doc/content/getting-started/the-things-stack-basics/_index.md | Remove legacy The Things Stack basics page |
| doc/content/getting-started/lorawan-basics/_index.md | Remove legacy LoRaWAN basics guide |
| doc/content/getting-started/glossary/_index.md | Add weight for ordering in Getting Started nav |
| doc/content/getting-started/faq/_index.md | Update FAQ description and weight |
| doc/content/getting-started/_index.md | Restructure overview, update description, steps, aliases |
| doc/content/getting-started/4-next-steps/_index.md | Rename title to “Step 4: Next steps” and adjust items |
| doc/content/getting-started/3-try-starter-kit/troubleshooting/_index.md | Add new troubleshooting page |
| doc/content/getting-started/3-try-starter-kit/control-remotely/_index.md | Add guide for sending downlinks to the end device |
| doc/content/getting-started/3-try-starter-kit/collect-visualize-data/_index.md | Add guide for data collection and visualization |
| doc/content/getting-started/3-try-starter-kit/activate/_index.md | Add activation guide for gateway and end device |
| doc/content/getting-started/3-try-starter-kit/_index.md | Create index for Starter Kit workflow |
| doc/content/getting-started/2-prerequisites/_index.md | Rename and re-alias setup network page to step 2 |
| doc/content/getting-started/1-understand-lorawan/_index.md | Add new LoRaWAN fundamentals guide as step 1 |
| doc/content/concepts/_index.md | Update alias/link for basics to new step 2 prerequisites |
| doc/content/cloud/_index.md | Update Cloud “get started” link to step 2 |
Comments suppressed due to low confidence (4)
doc/content/getting-started/3-try-starter-kit/troubleshooting/_index.md:1
- Add a
weightproperty in the front matter to ensure this page is ordered correctly in the Getting Started menu.
---
doc/content/getting-started/3-try-starter-kit/control-remotely/_index.md:19
- [nitpick] This step is redundant with the instruction at line 15. Consider removing the duplicate to avoid confusion.
In {{% tts %}} Console, select your application and go to the end device overview.
doc/content/getting-started/_index.md:13
- Alias is missing a trailing slash, which may break redirects. Consider using
/getting-started/what-is-tts/to match folder conventions.
/getting-started/what-is-tts/,
doc/content/getting-started/3-try-starter-kit/troubleshooting/_index.md:30
</br>is not a valid closing tag. Use<br/>or remove the closing tag to correct the HTML.
</br>
doc/content/getting-started/3-try-starter-kit/control-remotely/_index.md
Outdated
Show resolved
Hide resolved
happyRip
approved these changes
Jul 17, 2025
Member
happyRip
left a comment
happyRip
left a comment
There was a problem hiding this comment.
The new Getting Started section looks great.
I have a couple suggestions along with some nits Copilot found.
Co-authored-by: Copilot <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Update getting started section. References: https://github.com/TheThingsIndustries/product-management/issues/68
Screenshots
Changes
Checklist
make server, posted screenshots, verified external links. Test withHUGO_PARAMS_SEARCH_ENABLED=trueif style changes will affect the search bar.new-in-versionshortcode, according to the guidelines in CONTRIBUTING.