How to contribute?
Note: Regarding fixing of typo in existing cheat sheet, you can directly create a Pull Request otherwise follow the process below.
Follow these steps:
- Create an new Issue using either:
new_cheatsheet_proposaltemplate if you want to propose a new cheat sheet.
update_cheatsheet_proposaltemplate if you want to modify a existing cheat sheet.
- After a discution on the topic/update and if the proposal is accepted by the project leaders then:
- Clone this GitHub repository.
- Create the cheat sheet using the dedicated template in case of a new cheat sheet.
- Modify the target cheat sheet in case of a update/refactoring.
How to setup my contributor environment?
Follow these steps:
- Install Visual Studio Code (named
VSCodefrom here), it is cross platform and free.
- Install this plugin from VSCode.
- Open the file Project.code-workspace from VSCode via the menu
File > Open Workspace....
- You are ready to contribute
- Ensure that the markdown file you have created/modified do not have any warnings/errors raised by the linter, you can see it in this bottom bar when the markdown file is opened in VSCode:
- Ensure that the markdown file you have created/modified do not have any deadlinks. You can verify that by using this plugin, if you cannot use this plugin then, at least, verify that all the links are valid before to push:
- Install NodeJS to install NPM.
- Install the validation plugin via the command
npm install -g markdown-link-check
- Use this commmand (from the repository root folder) on your markdown file to verify the presence of any deadlinks:
$ markdown-link-check -c .markdownlinkcheck.json [MD_FILE]
See the example below:
$ markdown-link-check -c .markdownlinkcheck.json cheatsheets/Transaction_Authorization_Cheat_Sheet.md FILE: cheatsheets/Transaction_Authorization_Cheat_Sheet.md [✓] https://en.wikipedia.org/wiki/Time-based_One-time_Password_Algorithm [✓] https://en.wikipedia.org/wiki/Chip_Authentication_Program [✓] http://www.cl.cam.ac.uk/~sjm217/papers/fc09optimised.pdf ... # If the program do not say to you that you have deadlinks so it's OK # The identified deadlinks are showed using a red cross instead of a green tick before the link.