Skip to content

Add links to CSS sidebar#39445

Merged
dipikabh merged 6 commits intomdn:mainfrom
dipikabh:css-sidebar-missing-pages
May 9, 2025
Merged

Add links to CSS sidebar#39445
dipikabh merged 6 commits intomdn:mainfrom
dipikabh:css-sidebar-missing-pages

Conversation

@dipikabh
Copy link
Copy Markdown
Contributor

@dipikabh dipikabh commented May 7, 2025

Description

This PR adds a few existing landing pages to the sidebar that are not currently discoverable.
A broader CSS area reorganization is coming soon, but this improvement doesn't need to be delayed for that.

Motivation

To improve the discoverability of the landing pages we already have.

Additional details

We're currently lacking the functionality in the sidebar to do the following:

  • "At-rules" in the sidebar currently only shows the top-level items.
    I've tried using depth: 2 and adding css-at-rule-descriptor to tags, but the expected child folders (e.g., for @counter-style) don't show up.
    And we don't want the listSubPagesGrouped functionality here.

  • "Properties" in the sidebar (and same applies to pseudo-classes and pseudo-elements) are of type listSubPagesGrouped.
    As a result, we see -moz-* and -webkit-* groups but we don't have a handle on these top-level group items to link them to their respective landing pages. (Firefox (-moz-) vendor-prefixed CSS extensions and WebKit (-webkit-) vendor-prefixed CSS extensions).

@dipikabh dipikabh requested a review from a team as a code owner May 7, 2025 18:35
@dipikabh dipikabh requested review from bsmth and removed request for a team May 7, 2025 18:35
@github-actions github-actions bot added the size/s [PR only] 6-50 LoC changed label May 7, 2025
@bsmth
Copy link
Copy Markdown
Member

bsmth commented May 9, 2025

Super! Thank you very much. I think there's only one change I feel we should check and that's https://github.com/mdn/content/pull/39445/files#r2081301414 for Values and units entry.

Every other comment about listSubPages is a suggestion, so I'm happy to hear what you think.

@dipikabh dipikabh requested a review from a team as a code owner May 9, 2025 13:59
@dipikabh dipikabh requested review from chrisdavidmills and removed request for a team May 9, 2025 13:59
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed and removed size/s [PR only] 6-50 LoC changed labels May 9, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented May 9, 2025

Preview URLs

(comment last updated: 2025-05-09 14:15:48)

@dipikabh
Copy link
Copy Markdown
Contributor Author

dipikabh commented May 9, 2025

Thanks a lot @bsmth for reviewing. Using auto alpha sorting where possible is a great suggestion.
The position of Values and units was an error.

This is ready for you to take another look

Copy link
Copy Markdown
Member

@bsmth bsmth left a comment

Choose a reason for hiding this comment

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

Super, everything looks good, thank you!

@dipikabh dipikabh merged commit f14efcb into mdn:main May 9, 2025
8 checks passed
wbamberg added a commit to wbamberg/content that referenced this pull request May 21, 2025
* upstream/main: (40 commits)
  Add a guide on xs-leaks (mdn#38977)
  chore: Link to child pages in SVG, URI section (mdn#39470)
  Correct page title for `Uint8Array.prototype.setFromHex()` (mdn#39494)
  Bump markdownlint-cli2 from 0.17.2 to 0.18.0 (mdn#39488)
  Add more documentation for sizes=auto (mdn#39464)
  css(fix): update 'shape()' page (mdn#39454)
  Expand Compression Dictionary format description (mdn#39441)
  Add username/password section to URLs guide (mdn#39487)
  Fix typos (mdn#39481)
  CSS: mask-position property description (mdn#39449)
  Adding @starting-style to CSS nesting at-rules (mdn#39473)
  feat(aria): Add short titles, format titles for roles (mdn#39472)
  Fix Circle Collision detection algorithm (mdn#39484)
  Add warning against using element IDs as global properties. (mdn#39422)
  Fix typos in web audio spatialization basics (mdn#39476)
  More Error Messages (mdn#39419)
  Add links to CSS sidebar (mdn#39445)
  css: add 'stretch' value examples (mdn#39451)
  chore: link to unlinked child pages (mdn#39469)
  Fix typos (mdn#39465)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants