Before making any edits, it's important to understand that we treat content workflow differently based on the significance of the changes.
All new articles and major changes need to be accompanied by a content request via Bugzilla, while minor changes can be submitted directly in the article without content request.
What qualifies as minor changes
Here are what we consider to be minor changes:
- Fixing small typos
- Removing unnecessary white spaces
- Correcting spelling, grammar, or punctuation errors
- Fixing wiki markup formatting (headings, bullets, numbering, spacing, indentation)
- Updating small factual details (for example: version numbers, button or menu labels) without rewriting sections
- Enhancing clarity and overall user experience by simplifying instructions, improving readability, or incorporating visual cues (for example: icons and menu references) for accessibility.
- Updating broken links or updating links with the same target content
- Adjusting tone to meet Mozilla’s support content standards
- Replacing outdated UI screenshots with updated versions (2 or less)
- Updating keywords
- Adding or updating a search summary
What qualifies as major changes
Major changes to Knowledge Base (KB) articles require a Bugzilla request to begin the work and to be considered for the review and approval process. This helps us ensure accuracy, track changes properly, and prioritize review workflows.
Below are changes we consider major:
- Incorporating changes or updates for release readiness
- Correcting inaccurate or outdated content
- Removing content related to Firefox versions that are no longer supported
- Removing an existing section
- Extensive rewriting (entire paragraphs or sections)
- Substantial content additions (new instructions, FAQs, or troubleshooting steps)
- Large-scale formatting or structural changes (moving multiple sections, changing article flow)
- Adding visuals for accessibility
- Rewriting or renaming section headings
- Changing the scope or intent of the article
- Replacing outdated screenshots or adding new screenshots (more than 2)
- Updating, adding, or removing screencasts, GIFs, or videos
To learn more about Knowledge Base contribution, please check out How to contribute to the Knowledge Base.