-
Notifications
You must be signed in to change notification settings - Fork 522
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
feat: oss.gg accessibility audit #2328
base: main
Are you sure you want to change the base?
feat: oss.gg accessibility audit #2328
Conversation
…ity-1 Update 2_accessibility_advocate.md
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
@Emmarie-Ahtunan is attempting to deploy a commit to the Unkey Team on Vercel. A member of the Team first needs to authorize it. |
📝 Walkthrough📝 WalkthroughWalkthroughThe changes introduce a new section titled "Side Quest: Accessibility Advocate" in the document Changes
Assessment against linked issues
Suggested labels
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
CodeRabbit Configuration File (
|
Thank you for following the naming conventions for pull request titles! 🙏 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 0
🧹 Outside diff range and nitpick comments (3)
oss.gg/2_accessibility_advocate.md (3)
Line range hint
1-7
: LGTM! Consider adding more specific guidelines for the accessibility audit.The content clearly outlines the task, points system, and proof requirements for the accessibility audit. It's great that you emphasize the importance of original findings.
To further improve this section, consider adding:
- A brief list of key areas to focus on during the audit (e.g., color contrast, keyboard navigation, screen reader compatibility).
- Links to accessibility guidelines or tools that participants can use for the audit.
This additional information would help participants conduct more thorough and effective audits.
🧰 Tools
🪛 LanguageTool
[typographical] ~5-~5: If you want to indicate numerical ranges or time ranges, consider using an en dash.
Context: ...on’t copy from others⚠️ Points: 50 - 300 points depending on the severity **...(DASH_RULE)
[misspelling] ~7-~7: This word is normally spelled as one.
Context: ...en a bug issue in our repository incl. screen shots if relevant. ![Screenshot 2024-10-11 ...(EN_COMPOUNDS_SCREEN_SHOTS)
10-18
: Enhance screenshot presentation with descriptions and context.The addition of screenshots from the accessibility audit tool is valuable. However, to maximize their usefulness:
- Add a brief description below each screenshot explaining the key findings or issues highlighted.
- Consider grouping related issues together and providing an overall summary of the accessibility concerns identified.
- Ensure that the screenshots are accessible themselves by adding appropriate alt text.
Here's an example of how you could structure this:
### Color Contrast Issues ![Screenshot showing color contrast problems](image_url) *Description: This screenshot highlights areas where text color doesn't provide sufficient contrast with the background, potentially making it difficult for some users to read.* ### Keyboard Navigation ![Screenshot showing keyboard navigation issues](image_url) *Description: This image shows elements that are not properly accessible via keyboard navigation, which can pose challenges for users who rely on keyboard-only interaction.*By providing this context, you'll make the audit results more actionable and easier to understand for those reviewing the findings.
Line range hint
1-22
: Great start on the accessibility audit documentation. Consider enhancing its structure and content.The inclusion of both task description and visual evidence from the audit tool is commendable. To further improve the document and make it more valuable:
- Add an introduction explaining the importance of accessibility and the specific goals of this audit.
- Organize the findings into categories (e.g., color contrast, keyboard navigation, screen reader compatibility).
- For each category:
- Provide a brief explanation of why it's important for accessibility.
- Show the relevant screenshot(s).
- Describe the specific issues found.
- Suggest potential solutions or improvements.
- Include a summary section that highlights the most critical issues and outlines next steps.
- Consider adding a section on the methodology used for the audit, including any tools or guidelines followed.
This structured approach will not only make the document more comprehensive but also serve as a better guide for addressing the identified accessibility issues. It will also demonstrate a thorough understanding of accessibility principles, which aligns well with the "Accessibility Advocate" side quest objective.
🧰 Tools
🪛 LanguageTool
[typographical] ~5-~5: If you want to indicate numerical ranges or time ranges, consider using an en dash.
Context: ...on’t copy from others⚠️ Points: 50 - 300 points depending on the severity **...(DASH_RULE)
[misspelling] ~7-~7: This word is normally spelled as one.
Context: ...en a bug issue in our repository incl. screen shots if relevant. ![Screenshot 2024-10-11 ...(EN_COMPOUNDS_SCREEN_SHOTS)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 0
🧹 Outside diff range and nitpick comments (2)
oss.gg/2_accessibility_advocate.md (2)
21-22
: Comprehensive guideline on landmark usage.This guideline about ensuring all page content is contained by landmarks is crucial for proper document structure and navigation. The supporting link and image effectively illustrate the audit finding.
Consider adding a brief explanation of why landmarks are important for accessibility, to provide more context for developers who might be new to web accessibility.
8-26
: Excellent improvements to the accessibility audit checklist.The addition of these five specific accessibility guidelines greatly enhances the "Side Quest: Accessibility Advocate" section. Each guideline is well-structured with a clear description, a link to further resources, and supporting evidence in the form of an image.
To further improve this document:
- Consider adding a brief introduction before the guidelines to explain the importance of these specific checks in the context of web accessibility.
- You might want to include a summary or conclusion section that encourages developers to go beyond these guidelines and continuously learn about and implement accessibility best practices.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
📒 Files selected for processing (1)
- oss.gg/2_accessibility_advocate.md (1 hunks)
🧰 Additional context used
🔇 Additional comments (4)
oss.gg/2_accessibility_advocate.md (4)
9-10
: LGTM! Clear guideline with supporting resources.The addition of this accessibility guideline about ARIA attributes is valuable. The link to further resources is helpful, and the image provides good evidence of the audit finding.
12-13
: Excellent addition for improving keyboard accessibility.This guideline about keyboard accessibility for scrollable content is crucial for users who rely on keyboard navigation. The provided link and image effectively support the audit finding.
15-16
: Great focus on table accessibility.The guideline about ensuring discernible text for table headers is essential for screen reader users. The link and image effectively support this important accessibility requirement.
18-19
: Important structural guideline added.The inclusion of this guideline about ensuring a main landmark is crucial for proper document structure and navigation. The supporting link and image effectively illustrate the audit finding.
What does this PR do?
Fixes #2327
If there is not an issue for this, please create one first. This is used to tracking purposes and also helps use understand why this PR exists
Bug fix recommendations
How should this be tested?
Checklist
Required
pnpm build
pnpm fmt
console.logs
git pull origin main
Appreciated
Summary by CodeRabbit