Editing with Forks

We use forks because they give some benefits when making big changes to a GitHub repository.

Editing with a fork

To edit a rule with your forked repository, follow these steps:

1. Go to your forked repository: {User}/SSW.Rules.Content. If you don't have a fork of the SSW.Rules.Content repository, see Fork the repository (One-time setup) section below.
2. Make your changes to the repository. If you want to add a rule or category/top category, see How to Create Rules and How to Add and Edit Categories and Top Categories
3. Merge your changes, by following Merging Your Fork

Fork the repository (One-time setup)

1. Log in to GitHub, or create an account if you haven't already.

2. Navigate to SSW.Rules.Content - https://github.com/SSWConsulting/SSW.Rules.Content/

3. Fork it!
   
   Figure: Fork this repo!

Forking makes a duplicate of the Rules repository (i.e. SSWConsulting/SSW.Rules.Content to SSWSophieBelle/SSW.Rules.Content). As SSWConsulting/SSW.Rules.Content is a public repository, we do not have permission to write to it directly. This is for security reasons.

4. Fork it under your own GitHub account:
   Figure: You'll need to create a GitHub account if you haven't.

5. You should end up with your own forked repository:
   Figure: Check that it has YourAccountName/SSW.Rules.Content on the left

6. IMPORTANT: Enable Workflows in your GitHub Fork
   
   Figure: Enable Workflows on your GitHub Fork