Creating Editing top categories

Add a top-category

If you think rules could have a new top-category, follow these steps:

1. Open the GitHub SSW.Rules.Content repo and open the 'categories' folder
2. Click Add file | Create new file
3. Name your file '{top-category name}/index.md' (e.g, 'software-development/index.md')
4. Edit the index.md file, you need to add the following fields in the frontmatter
   • type: value must be set to 'top-category'
   • title: the title of the top-category, this will be display on the home page (e.g Software Development)
   • uri: the URI for the new category (e.g. software-development)
   • index: A markdown list of categories URI composing the top-category

Example top category:

---
type: top-category
title: Software Development
uri: software-development
index:
- rules-to-better-net-projects
- rules-to-better-architecture-and-code-review
- rules-to-better-azure
- rules-to-better-devops
- rules-to-better-mvc
- rules-to-better-bots
- rules-to-better-clean-architecture
- rules-to-better-bug-management-and-feedback
- rules-to-better-user-acceptance-tests-uat-for-bug-management
- rules-to-better-crm-for-developers
- rules-to-better-power-platform
- rules-to-better-sharepoint-for-developers
- rules-to-better-code-commenting
---

Figure: Frontmatter example for a top-category

Edit a top-category

To edit a top-category, follow these steps:

1. Open the GitHub SSW.Rules.Content repo
2. Open the folder 'categories', then the folder with the top-category name
3. Open the 'index.md' file
4. Click on the pencil
5. Make the changes you want
6. Save your change, see Saving rules

---

Next Step: 4. Creating/Editing categories