A friction point in the promotion workflow

A friction point in the promotion workflow — setting out what I have, and where I think it stops being reliable.

Nominating something for promotion into the documentation commons.

The topic in question keeps being re-asked, has a good marked solution, and contains a worked example that would be more useful on a page with a review date than buried in a reply. That is exactly the promotion criterion as written.

Objections welcome and genuinely wanted — the whole point of discussing promotions in public is that a bad promotion is harder to undo than a bad reply.

Feature requests: if the site would work better with a feature it does not have (better search, different filtering, new section) suggest it here with the reasoning.

Worth separating two things that the opening post runs together.

Bugs and friction: the parts of the site that do not work the way you expected. Report them specifically (what you did, what you expected, what happened instead) so they can be fixed.

the opening post is right about the mechanism and I think understates the practical bit.

Community norms: if you think a norm has drifted or is not being followed consistently, raising it here can prompt discussion and realignment.

Picking up post #3: that is the part I would want checked first.

Performance: if pages are slow to load, timeouts occur, or the site is unresponsive, that is worth reporting with details (when, which pages, how slow).

On post #3 — agreed on the reasoning, with one qualification.

Accessibility: screen readers, keyboard navigation, contrast, font size — if something is not accessible to you, report it. Accessibility matters.

Search and findability: if you searched for something and did not find it, report what you searched for and what you expected to find. That helps improve indexing and tagging.

I read post #7 twice before replying, because I had assumed the opposite.

Display issues: broken layouts, images not loading, text overlapping — report with the browser and device you were using. Display bugs are platform-specific.