This is a generic project template, without a specific programming language. It should follow the general workflow for the organization, and should be used when creating a new project.
More specific templates will be available later for more specialized projects (backend api, web front ...), with CI/CD already setup. Fore more information, see the organization's templates.
- Default MIT license
- README.md template with badges
- Issue labels
- Issue templates (soon)
- Branch protection rules
- Click on the "Use this template" button on the top right of the repo's page.
- Follow the next steps to setup the newly created repository
To follow the git flow structure, create a branch named main, and import the rulesets located in the rulesets folder. You can delete the folder after importing.
Change the assignees for each issue template in the .github/ISSUE_TEMPLATE folder.
The easiest way to use this README template is with a text editor that supports replacing strings with regexp (eg. vscode).
This badge displays the CodeClimate maintainability report for the repository. For this badge to work, you need to add the created repository in codeclimate.
Login with your github account, the CETEN-BDE organization should already allow access for codeclimate. Contact the CETEN-BDE maintainers if you need help for this step.
If the repository needs to remain private, or maintainability is irrelevant, remove the badge from the top of the README.
Fill the README template below these instructions. You can replace the following placeholders :
PROJECT_TITLE: The project name, used in the titlebasic-project: The name of the repository (the part after the organization's name in the URL)
When everything is setup, remove these instructions from the README. This can be done eaysily by replacing the following regexp with an empty string :
<!-- TEMPLATE INSTRUCTIONS -->(.|\n)*<!-- TEMPLATE INSTRUCTIONS -->Following this line is the README.md template to fill.
Quick description of the project, what's its use
Provide the steps to setup a working copy locally here. Exemple :
To get a local copy up and running follow these steps.
This is an example of how to list things you need to use the software and how to install them.
- npm
npm install npm@latest -g
- Get a free API Key at https://example.com
- Clone the repo
git clone https://github.com/CETEN-BDE/basic-project.git
- Install NPM packages
npm install
- Enter your API in
config.jsconst API_KEY = 'ENTER YOUR API';
Use this space to show useful examples of how a project can be used. Additional screenshots, code examples and demos work well in this space. You may also link to more resources.
For more examples, please refer to the Documentation
See the organization's contributing guidelines