Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Conversation

@st0012
Copy link
Member

@st0012 st0012 commented Nov 12, 2025

Similar to #12226 but slightly more ambitious.

I think it's be great if we can reorganize the top level page documents because

  • The list is currently super long, which requires readers to always scroll down to see the class list

    See the screenshot Screenshot 2025-11-13 at 22 21 57
  • The pages are not well organized so it's not clear how pages are related to each other or their purpose, without clicking into them

(It also annoys me that the names are all underscored. I'd like to change it but it'd be a RDoc feature instead)

This PR is for

  • Moving current top-level pages into similar groups
  • Renaming some of the pages for clarification
  • Updating all the related rdoc-ref references in the code

This PR is NOT for

  • Rewriting or merge existing documentations' contents
  • Cleanup unused page documentations

After

Pages list folded Screenshot 2025-11-13 at 22 29 36
Pages list with `language` folder expanded Screenshot 2025-11-13 at 22 29 36

Help needed

  • Better name for the language group. Maybe language_features?
  • Better names for pages

@launchable-app

This comment has been minimized.

@st0012 st0012 force-pushed the reorganize-docs-again branch from c4e61a0 to 5879e70 Compare November 13, 2025 04:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant