Official repository to the Security Frameworks by SEAL. This repository contains the entire structure and contents of the frameworks. Feel free to suggest from new categories to grammar corrections. Collaboration is open to everyone. This is a work in progress.
If you want to know more about the frameworks or take a peek at the live book go to the following branches below: Main, Development.
Production will be at frameworks.securityalliance.org, but not yet available.
gh repo clone security-alliance/frameworksgit checkout developcargo install mdbook mdbook-admonish mdbook-catppuccin./serve.sh
There are currently two ways to collaborate. The first one is by logging from your Vercel account and commenting directly on the deployed version of the book, and the second one is by forking the repository and creating a pull request.
To comment on the live version of the book under development, you will need to log in to your Vercel account. Please visit this link, which includes a read access token. A floating window will appear at the bottom, and you'll be ready to go.
- Fork the repository. Click on the "Fork" button at the top right corner of the page.
- Clone the forked repository to your local machine. Open your terminal or command prompt.
git clone https://github.com/your-username/frameworks.git - Make sure you're in the develop branch first.
git checkout develop - Inside the folder create a new branch based on
develop.git checkout -b develop - Make your changes.
- Make sure your changes don't break anything by testing it in the local setup (see above).
./serve.sh. - Commit your changes.
git add . - Commit the changes with a descriptive message:
git commit -m "Fixing typos and improving readability on XXX section" - Push the changes to your forked repository.
git push origin develop - Create a pull request. Go to your forked repository on GitHub. You should see a "Compare & pull request" button. Click on it. Provide a descriptive title and description for your pull request.
- Click on the "Create pull request" button.
- Wait for review. Once your pull request is approved, and no more changes are needed, we will merge it into the main repository.
- Congratulations! Your changes are now part of the security frameworks!
Editors merge PRs and push suggestions to the main branch which will be reflected on the live book.
git checkout maingit fetch origin developgit merge origin/develop- Manually merge files, solve conflicts and add a description.
- Using the
serve.shscript instead of mdBookservecommand is needed to be able to see properly the local deployment.