README.dev.md

.github

🔧 Development

To contribute to Certego CI, please:

• clone this repository
• follow Setup section
• do pull requests to develop.

Otherwise you can simply open an issue.

📖 Setup

CI files of base directory must be hard linked in the .github/.github folder, so they can be tested. Since GitHub is not able to store the fact that these files are hardlink, you need to restore it executing this script at every checkout.
From project root:

.github/hooks/post-merge

First time is mandatory, then a post-merge hook has been made to do it automatically:

cd .git/hooks
ln -s ../../.github/hooks/post-merge

Alternatively you can execute the script manually every time you need.
Now all changes will be linked and be tested with test project on every PR.
Important:

• Please remember to stage both base and .github files before commit.
• Links are for the single files. If you add directories, move or add files, you need to re-execute (or even modify) the script.

🕑 Files to update periodically

Periodically update:

• Test projects dependencies: Python dependencies, Node.js packages
• Node linters dependencies: ESLint packages, Stylelint packages
• Pre-commit config actions revs.
• All external actions revs.
• All README and docs.

🏷️ Release

After a new release is created, please inform final users that they should update CI subtree in their projects.