docs: meta descriptions for every page that had none - #8698
Merged
Merged
Conversation
Search results and link previews showed the first paragraph, or nothing, for these pages. Each now has a meta.description of one sentence, around 140 characters, saying what the page lets the reader do. Only frontmatter changes. Two pages carried a misspelled key (`descriptions:` on admin/introduction, `descripition:` on install/first-run) that nothing read; they are replaced by the real key. persistent-context.md had no frontmatter and gains a block.
devops-pipelines, expert/chat, role-based-access-control and snapshots reached main without a meta.description after the previous commit was written, so it no longer covered every page. Same shape: one sentence, around 140 characters, saying what the page lets the reader do.
Three pages linked the MCP server nodes at https://flowfuse.com/node-red/flowfuse/mcp/, which has 301d to /docs/flowfuse-nodes/mcp/ since the Node-RED library moved into /docs. They now link the page directly. The URL stays absolute because the page lives in FlowFuse/website, so a /docs/... path would fail the repo-relative link check here.
hardillb
approved these changes
Sep 29, 2026
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Description
Adds a one-sentence
meta.descriptionto every docs page that had none, and replaces two misspelled keys (descriptions:,descripition:) that nothing read. It also links the MCP server nodes at/docs/flowfuse-nodes/mcp/instead of the old/node-red/URL, which 301s. The descriptions start rendering on flowfuse.com once FlowFuse/website#5625 merges.Related Issue(s)
https://flowfuse.slack.com/archives/C02TG4WH5PC/p1790618200472239
Checklist
flowforge.yml?FlowFuse/helmto update ConfigMap TemplateFlowFuse/CloudProjectto update values for Staging/ProductionLabels
area:migrationlabel