-
Notifications
You must be signed in to change notification settings - Fork 265
Update style-guide.mdx #1070
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update style-guide.mdx #1070
Conversation
The American formatting of dates is incredibly confusing to the international audience. I highly recommend we update to the more accessible `yyyy/mm/dd` which also has the added benefit of automatically sorting any dated files by recent to oldest.
✅ Deploy Preview for docs-optimism ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
Caution Review failedThe pull request is closed. WalkthroughThe pull request introduces a comprehensive style guide for writing technical content for Optimism Docs. It includes a metadata block for SEO and accessibility, a structured Table of Contents, and various sections covering naming conventions, writing style, accessibility guidelines, meta tags, content types, and general formatting rules. The guide aims to enhance the clarity, organization, and accessibility of the documentation. Changes
Possibly related PRs
Suggested reviewers
Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media? 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
Documentation and Community
|
The American formatting of dates is incredibly confusing to the international audience.
I highly recommend we update to the more accessible
yyyy/mm/dd
which also has the added benefit of automatically sorting any dated files by recent to oldest.