Merge branch 'develop' into 'master'

Merge develop into master for initial push to GitHub

See merge request global/api-dev-guidelines!4

Author: paulvet1

GUIDELINES.md renamed to API-Guidelines.md

@@ -1,16 +1,14 @@
 # Contribution guidelines
+
 ## Welcome!
 We're so glad you're thinking about contributing to an Ontario Digital Service (ODS) project! If you're unsure about anything, just ask -- or submit the issue or pull request anyway. The worst that can happen is you'll be politely asked to change something. We love all friendly contributions.
+
 We want to ensure a welcoming environment for all of our projects. Our staff follow the ODS Code of Conduct and all contributors should do the same.
 
 We encourage you to read this project's contributing policy (you are here), its [license](LICENSE.md), and its [README](README.md).
 
-## Licensing
-This project is copyright the Queen’s Printer in Ontario.
-
-All contributions to this project will be released under the same licence as this file. By submitting a pull request, you are agreeing to comply with this licensing condition.
-
 You can share your thoughts and ideas by:
+
 * emailing us at digital.standard@ontario.ca
 * forking our GitHub repository
 
@@ -21,14 +19,14 @@ You can share your thoughts and ideas by:
 * Tell us what section your suggestions apply to
 * If you’re sending email or plain text: include the original text for reference and your proposed changes
 * If you’re sending a Word or Google document: use track changes or suggest mode
-Tell us the reason for your suggestion and the benefit it will have
+* Tell us the reason for your suggestion and the benefit it will have
 
 ### On GitHub
 
-NOTE: The develop branch is a working draft. The official version is in the master branch.
-Use markdown to format your changes
+NOTE: The `develop` branch is a working draft. The official version is in the master branch.
 
+* Use [Markdown](https://www.markdownguide.org/getting-started) to format your changes
 * Don't use HTML unless the changes you want to make are not supported in markdown (for example, headings inside a table)
-* Fork off of our develop branch, and make a pull request back to develop when you’re ready to merge.
+* Fork off of our `develop` branch, and make a pull request back to develop when you’re ready to merge.
 * Name your branch with your first name or user name, the type of change (“fix” for small cosmetic edits,  “feature” for any additions or deletions), followed by a description of your changes. For example: `name/fix/correcting-typos` OR `name/feature/updates-to-standard`
 * Make one commit per change and explain the reasoning for your change in your commit message (not what you changed, but why)

CONTRIBUTING.md

@@ -0,0 +1,32 @@
+# Lignes directrices en matière de contributions
+
+## Bienvenue!
+Nous sommes très heureux que vous songiez à contribuer à un projet des Services numériques de l’Ontario (SNO)! Si vous ne comprenez pas quelque chose, posez des questions – ou soumettez le problème ou la demande d’extraction de toute façon. Le pire qui pourrait arriver est qu’on vous demandera poliment de changer quelque chose. Nous aimons toutes les contributions amicales.
+
+Nous voulons nous assurer que tous nos projets profitent d’un environnement amical. Notre personnel respecte le code de conduite des SNO, et tous les contributeurs devraient en faire de même.
+
+Nous vous encourageons à lire la politique en matière de contributions de ce projet (vous y êtes), sa [licence](LICENCE-FR.md) et son fichier [README](README-FR.md).
+
+Vous pouvez partager vos réflexions et vos idées en :
+
+* nous envoyant un courriel à digital.standard@ontario.ca
+* créant une fourche à partir de notre référentiel GitHub
+
+### Par courriel
+
+* Envoyez-nous les documents en texte en clair, comme les fichiers texte, les documents Word et les Google Docs par courriel
+* N’envoyez pas de documents en format HTML ou PDF, des documents imprimés ou des notes manuscrites
+* Dites-nous à quelle section vos suggestions s’appliquent
+* Si vous envoyez un courriel ou du texte en clair, incluez le texte original à des fins de consultation avec vos changements proposés
+* Si vous envoyez un document Word ou Google, utilisez le suivi des modifications ou le mode suggestion
+* Dites-nous la raison de votre suggestion et ses avantages
+
+### Sur GitHub
+
+REMARQUE : La branche `develop` est une ébauche. La version officielle est dans la branche « master ».
+
+* Utilisez [Markdown](https://www.markdownguide.org/getting-started) pour formater vos changements
+* N’utilisez pas HTML, sauf si les changements que vous souhaitez apporter ne sont pas acceptés par Markdown (par exemple, des entêtes dans un tableau)
+* Créez une fourche à partir de notre branche `develop`, et faites une demande d’extraction vers « develop » lorsque vous êtes prêt à fusionner.
+* Nommez votre branche en utilisant votre prénom ou nom d’utilisateur, le type de changement (« fix » pour de petites modifications cosmétiques, « feature » pour les ajouts ou les suppressions), suivis d’une description de vos changements. Par exemple : `nom/fix/correcting-typos` OU `nom/feature/updates-to-standard`
+* Faites une validation par changement et expliquez la raison de votre changement dans votre message de validation (pas ce que vous avez changé, mais pourquoi)

CONTRIBUTIONS-FR.md

@@ -0,0 +1,7 @@
+# Licence d’utilisation
+
+Le droit d’auteur de ce projet appartient à l’Imprimeur de la Reine en Ontario.
+
+Ce projet est visé par la [Licence publique Creative Commons Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/legalcode.fr)
+
+Toutes les contributions à ce projet seront publiées sous la même licence que ce fichier. En soumettant une demande d’extraction, vous acceptez de respecter la présente condition de la licence.

LICENCE-FR.md

@@ -0,0 +1,7 @@
+# License
+
+This project is copyright the Queen’s Printer in Ontario.
+
+This work is further licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).
+
+All contributions to this project will be released under the same licence as this file. By submitting a pull request, you are agreeing to comply with this licensing condition.