Creating Editing categories

Add a category

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

1. Open the GitHub SSW.Rules.Content repo and open the 'categories/{top-category name}' (e.g. 'categories/Communication) folder
2. Click Add a new file
3. Name your file '{category name}.md' (e.g. 'rules-to-better-communication.md')
4. Edit the index.md file, you need to add the following fields in the frontmatter
   • type: value must be set to 'category'
   • title: the title of the category, this will be display on the home page and the category page
   • index: list of categories URI composing the top-category
   • uid: same as the name of the file without the extension
   • guid: a unique guid used to identify the category in the Cosmos DB
5. You can add a summary for the category using SSW.Rules Markdown syntax, it is recommended to keep it simple.

Edit a category

If you need to edit a category, follow these steps:

1. Click on the edit button on the SSW Rules category page
2. Once on GitHub, click on the pencil button
3. Make the changes you want
4. Save your change see Saving rules

---
type: category
title: Rules to Better Communication
guid: 471816bf-f0df-4835-bf4d-66a90f6f1adc
uid: rules-to-better-communication
index:
- communication---do-you-know-the-best-chat-tools-for-your-employees
- communication---do-you-know-the-options-for-remote-meetings
- do-you-always-call-first-before-emailing

---
This is a summary for the category

Figure: Frontmatter example for a top-category

For the SSW.Rules markdown syntax, read the sample page

WARNING: Do not leave categories empty.

Next Step: 5. Creating rules