best practices

Author: ethanpalm

text.mdx

@@ -199,20 +199,15 @@ This line starts on a new line.
 
 ### Content organization
 - Use headers to create clear content hierarchy
-- Keep header levels logical (don't skip from H2 to H4)
+- Follow proper header hierarchy (don't skip from H2 to H4)
 - Write descriptive, keyword-rich header text
 
 ### Text formatting
 - Use bold for emphasis, not for entire paragraphs
 - Reserve italics for terms, titles, or subtle emphasis
 - Avoid over-formatting that distracts from content
 
-### Links and navigation
-- Write descriptive link text instead of "click here"
-- Validate links regularly to maintain documentation quality
+### Links
+- Write descriptive link text instead of "click here" or "read more"
 - Use root-relative paths for internal links
-
-### Accessibility
-- Ensure sufficient color contrast for all text
-- Use semantic formatting (headers for structure, not styling)
-- Provide alternative text for any embedded content
+- Test links regularly to prevent broken references