SSWConsulting / SSWConsulting/SSW.Rules.Content

🦅 ContentHawk - Content Audit: Update popup/modal guidance and accessibility notes

Open Beginner friendly
#12,591 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

update-rules-better-javascript
Dominant language
MDX
Stars
62
Forks
196
Avg merge
1d 4h
Merged PRs (30d)
112

Description

File

public/uploads/rules/dont-open-popup-windows-use-a-javascript-modal-instead/rule.mdx

Finding

lastUpdated: 2016-11-17. The rule focuses on avoiding popup windows and using anchor tags or JavaScript onclick to open windows. It doesn't mention modern accessibility, focus management for modals, rel="noopener" for external links, or recommending accessible dialog patterns.

Suggestions
  • Update to recommend accessible modal patterns (focus trap, ARIA roles, keyboard support) and link to WAI-ARIA Authoring Practices.
  • Add security recommendation for external links (rel="noopener noreferrer") and advise when to use target vs. modals.
  • Suggest modern modal libraries or native dialog element with progressive enhancement examples.

contenthawk-run-id: 24946376720

Generated by Content Judge (Agent 2a) ·

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with public/uploads/rules/dont-open-popup-windows-use-a-javascript-modal-instead/rule.mdx and review the WAI-ARIA Authoring Practices guidance mentioned in the issue. Update the rule with accessible modal, external-link security, target-versus-modal, and progressive-enhancement guidance. Done means the file clearly covers the requested accessibility and security notes with relevant examples or links.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown
Domain
accessibility, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
70/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.