Skip to content

Conversation

@jeshecdom
Copy link
Contributor

@jeshecdom jeshecdom commented Dec 5, 2025

Closes #1540.

@anton-trunov anton-trunov added the 3p Reviewed by someone else (a third party). Used for filtering PRs. Don't mind this. label Dec 11, 2025
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Thanks for the updates here; I’ve left a couple of suggestions in languages/fift/fift-assembler.mdx: please apply the inline suggestions.

Comment on lines 1 to 5
---
title: "Assembler"
sidebarTitle: "Assembler"
noindex: "true"
---

Choose a reason for hiding this comment

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

[HIGH] Frontmatter title is an unsupported one‑word generic label

The new page frontmatter sets title: "Assembler" and sidebarTitle: "Assembler", which is a one‑word generic title that does not clearly describe the page content. The style guide’s “Title vs sidebar semantics” rule requires page titles to be context‑free and self‑describing, and explicitly forbids one‑word generic titles such as “Overview” or “Introduction” on non‑top‑level pages. This page lives under the Fift group rather than at a top‑level route, and “Assembler” is not a proper name or established term here, so the current title reduces discoverability and makes deep links and search results less informative. The sidebarTitle can remain concise and contextual, but the title should be expanded to clearly identify the Fift assembler topic.

Suggested change
---
title: "Assembler"
sidebarTitle: "Assembler"
noindex: "true"
---
---
title: "Fift assembler"
sidebarTitle: "Assembler"
noindex: "true"
---

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

---
title: "Assembler"
sidebarTitle: "Assembler"
noindex: "true"

Choose a reason for hiding this comment

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

[MEDIUM] Missing noindex boolean type in frontmatter

The frontmatter noindex key is set to the string "true" instead of a boolean literal. Site tooling and search/indexing logic typically expect frontmatter flags like noindex to be consistently typed booleans so they can be parsed without special cases. Leaving this as a string can cause incorrect indexing behavior or require bespoke parsing logic.

Suggested change
noindex: "true"
noindex: true

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Is this really an issue?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3p Reviewed by someone else (a third party). Used for filtering PRs. Don't mind this.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Fift > Assembler]

3 participants