-
Notifications
You must be signed in to change notification settings - Fork 195
How to Create Rules (Tina)
Chloe Lin [SSW] edited this page Nov 20, 2025
·
5 revisions
Tip: use the Rules to Better Technical Documentation to help you create consistent and high quality rule content
- Go to SSW Rules Beta
- Click the 'New Rule' button.
Figure: New Rule button.
- Open the Rules collection and select Add File
- Fill out the Title and URI fields
- Click Save. You will then be guided to create a new branch for your changes
- Click "Save to a new branch" and wait for Tina to create a pull request on GitHub for your new branch.
- Once the process is finished, edit the rest of your rule. Go to the Rules collection and find your new rule at the top of the list. Open it to edit, and make sure to link it to at least one category.
Note: In the body’s rich-text editor, you can click Embed to add specific items (Introduction, Email, Image, YouTube, etc.)

-
Click "Save" again. Your changes will be committed automatically to your branch and your pull request
-
Navigate to SSW.Rules.Content | Pull Requests and open your pull request. Add a title and fill out the description fields (As per Do you know how to write a good pull request?)
-
Once everything looks good, scroll down and click "Ready for review" 😉
- How to Create Rules
- How to Edit Rules
- How to Rename Rules
- How to Add and Edit Categories and Top Categories
- How to Rename Categories
- Check Images
- Check For Duplicate Image Names
- Check Extension Case
- Check Folder Name
- Manage Stale PRs
- T‐shirt Size the PR
- Trigger Rules Build
- Validate Frontmatter
- Validate Frontmatter in All Rules
- Validate Markdown