From f70304078f3f935dd28233957b5f1af1b1f7d485 Mon Sep 17 00:00:00 2001 From: jboix Date: Tue, 27 Feb 2024 10:28:52 +0000 Subject: [PATCH] =?UTF-8?q?Deploy=20preview=20for=20PR=2014=20=F0=9F=9B=AB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- pr-preview/pr-14/.nojekyll | 0 pr-preview/pr-14/README.md | 34 +++++++ pr-preview/pr-14/_sidebar.md | 10 ++ .../pr-14/guides/CODE_OF_CONDUCT_GUIDE.md | 20 ++++ pr-preview/pr-14/guides/CONTRIBUTING_GUIDE.md | 27 ++++++ pr-preview/pr-14/guides/LICENSE_GUIDE.md | 33 +++++++ pr-preview/pr-14/guides/README_GUIDE.md | 95 +++++++++++++++++++ pr-preview/pr-14/img/rts-logo.svg | 13 +++ pr-preview/pr-14/index.html | 36 +++++++ 9 files changed, 268 insertions(+) create mode 100644 pr-preview/pr-14/.nojekyll create mode 100644 pr-preview/pr-14/README.md create mode 100644 pr-preview/pr-14/_sidebar.md create mode 100644 pr-preview/pr-14/guides/CODE_OF_CONDUCT_GUIDE.md create mode 100644 pr-preview/pr-14/guides/CONTRIBUTING_GUIDE.md create mode 100644 pr-preview/pr-14/guides/LICENSE_GUIDE.md create mode 100644 pr-preview/pr-14/guides/README_GUIDE.md create mode 100644 pr-preview/pr-14/img/rts-logo.svg create mode 100644 pr-preview/pr-14/index.html diff --git a/pr-preview/pr-14/.nojekyll b/pr-preview/pr-14/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/pr-preview/pr-14/README.md b/pr-preview/pr-14/README.md new file mode 100644 index 0000000..c802886 --- /dev/null +++ b/pr-preview/pr-14/README.md @@ -0,0 +1,34 @@ +# RTS Development Guidelines + +A guide for promoting best practices among RTS code repositories. + +## Introduction + +The software industry is constantly evolving. Our own practices should similarly evolve to +disseminate knowledge throughout teams, share ownership, make it easier for newcomers to start and +for seasoned developers to contribute to any project. + +## Guides + +The following guides are offered to help you improve your repository: + +- [Readme Guide](./guides/README_GUIDE.md): Write a great introductory text for your repository. +- [Contributing Guide](./guides/CONTRIBUTING_GUIDE.md): Ensure smooth collaboration and + contribution to your project. +- [Code of Conduct Guide](./guides/CODE_OF_CONDUCT_GUIDE.md): Provide guidelines to ensure + everyone can safely contribute. +- [License Guide](./guides/LICENSE_GUIDE.md): Pick an appropriate license. + +> [!TIP] +> GitHub Community Standards are a great source of information and best practices. You can check +> that your project follows these standards at any time by checking _Community Standards_ under the +_Insights_ section. + +More sources are available online for further reading; you can start exploring them +at [opensource.guide](https://opensource.guide/). + +[open-issues]: https://github.com/SRGSSR/guilde-plateformes-propres/issues/new + +[submit-pr]: https://github.com/SRGSSR/guilde-plateformes-propres/compare + +[discussions]: https://github.com/SRGSSR/guilde-plateformes-propres/discussions diff --git a/pr-preview/pr-14/_sidebar.md b/pr-preview/pr-14/_sidebar.md new file mode 100644 index 0000000..ebb0d25 --- /dev/null +++ b/pr-preview/pr-14/_sidebar.md @@ -0,0 +1,10 @@ + +RTS Development Guidelines +* [Home](/) + +**Guides** + +* [Crafting a Readme](/guides/README_GUIDE.md) +* [Understanding Licenses](/guides/LICENSE_GUIDE.md) +* [Contributor's Handbook](/guides/CONTRIBUTING_GUIDE.md) +* [Code of Conduct Guidelines](/guides/CODE_OF_CONDUCT_GUIDE.md) diff --git a/pr-preview/pr-14/guides/CODE_OF_CONDUCT_GUIDE.md b/pr-preview/pr-14/guides/CODE_OF_CONDUCT_GUIDE.md new file mode 100644 index 0000000..f43db1b --- /dev/null +++ b/pr-preview/pr-14/guides/CODE_OF_CONDUCT_GUIDE.md @@ -0,0 +1,20 @@ +# Code of Conduct Guide + +Promote a welcoming and safe environment for discussions and contributions. + +> [!TIP] +> More information is available from [GitHub documentation][github-documentation]. + +## Picking a Code of Conduct + +The [Contributor Covenant][contributor-covenant] provides a great Code of Conduct. You can use it +as-is, adapt it to your needs, or write your own document. + +## Adding a Code of Conduct + +Add a file called `CODE_OF_CONDUCT.md` to the root of your repository, the `docs` folder, or +the `.github` folder, with the text of the Code of Conduct you chose. GitHub automatically adds a +link to this file in the _About_ section of your repository homepage. + +[github-documentation]: https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project +[contributor-covenant]: https://www.contributor-covenant.org/ diff --git a/pr-preview/pr-14/guides/CONTRIBUTING_GUIDE.md b/pr-preview/pr-14/guides/CONTRIBUTING_GUIDE.md new file mode 100644 index 0000000..25877f2 --- /dev/null +++ b/pr-preview/pr-14/guides/CONTRIBUTING_GUIDE.md @@ -0,0 +1,27 @@ +# Contributing Guide + +Provide more context about contributions you are looking for and how they should occur. + +> [!TIP] +> More information is available from [GitHub documentation][github-documentation]. + +## Writing Contributing guidelines + +Writing Contributing guidelines depends on your project and how your team decides to process +contributions. To help you: + +- The [Pillarbox Contributing guidelines][pillarbox-contributing] is an example describing which + contributions are considered, how they should occur (with links to the corresponding templates) + and how they will be processed. +- The following [template][contributing-template] can be used if you need to write Contributing + guidelines tailored to your needs. + +## Adding Contributing guidelines + +Add a file called `CONTRIBUTING.md` to the root of your repository, the `docs` folder, or +the `.github` folder, with the text you wrote. GitHub automatically adds a link to this file in the +_About_ section of your repository homepage. + +[github-documentation]: https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors +[pillarbox-contributing]: https://github.com/SRGSSR/pillarbox-apple/blob/main/docs/CONTRIBUTING.md +[contributing-template]: https://github.com/nayafia/contributing-template diff --git a/pr-preview/pr-14/guides/LICENSE_GUIDE.md b/pr-preview/pr-14/guides/LICENSE_GUIDE.md new file mode 100644 index 0000000..b60a24f --- /dev/null +++ b/pr-preview/pr-14/guides/LICENSE_GUIDE.md @@ -0,0 +1,33 @@ +# License Guide + +Make applicable license conditions transparent. + +> [!TIP] +> More information is available from [GitHub documentation][github-documentation]. + +## Choosing a license + +The following [online guide](https://choosealicense.com/) is an excellent way to pick a license. + +## Adding a license + +Add a file called `LICENSE` to the root of your repository, the `docs` folder, or the `.github` +folder, with the text of the license you chose. GitHub automatically adds a link to this file in the +_About_ section of your repository homepage. + +You can either repeat the license in each file requiring it but this is generally cumbersome. To +make your life easier you can use the following reduced license instead, which points to the main +license file for more information: + +``` +// +// Copyright (c) SRG SSR. All rights reserved. +// +// License information is available from the LICENSE file. +// +``` + +Avoid dates in license information since they have no real values and are likely never correctly +updated. + +[github-documentation]: https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-license-to-a-repository diff --git a/pr-preview/pr-14/guides/README_GUIDE.md b/pr-preview/pr-14/guides/README_GUIDE.md new file mode 100644 index 0000000..913bfeb --- /dev/null +++ b/pr-preview/pr-14/guides/README_GUIDE.md @@ -0,0 +1,95 @@ +# Crafting a Readme + +A well-structured and informative README is more than just documentation; it's a powerful tool for +collaboration. Your README serves as the gateway for developers to understand and contribute to your +project. + +## Why it Matters + +- **Reduces Barriers to Entry:** A clear and welcoming README lowers the learning curve, making it + easier for new contributors to understand the project and start contributing. +- **Encourages Contribution:** By providing explicit guidelines on how to contribute, your README + becomes an invitation for developers to actively participate in the project. +- **Fosters Transparency:** A well-crafted README sets the tone for open and transparent + communication. + +## The Template + +This template will assist you in creating a compelling and concise README for your project. It +provides step-by-step guidance on introducing your project and providing essential information for +setting up and running your application. + +> [!Tip] +> Enhance your project's visual appeal with a representative image and badges. +> Explore [Adding workflow badges][workflow-badges] for guidance. If your project is an application, +> include production version links (e.g., app store links) and incorporate screenshots to showcase +> its appearance. + +> [!Warning] +> Avoid adding a table of contents unless it serves a specific purpose, as GitHub generates one +> automatically. + +--- + +```markdown +# + +> Introduce your project with a clear overview of its goals, providing +> essential context and addressing fundamental questions. + +## Quick Guide + +**Prerequisites and Requirements** + +> List any prerequisites or requirements needed before setting up the project. + +**Running the Application** + +> Provide instructions on running the application locally for application projects. + +> For libraries, components, or frameworks, explain a typical setup, including +> installation from a package distribution manager and a simple use case. +> Avoid detailed development environment setup in this section. + +## Documentation + +> Include links to additional documentation resources related to your project in +> this section. + +## Contributing + +> Clarify how others can contribute to the project, with guidelines for bug +> reports, feature requests, or code contributions. Add a link to the Contribution +> guidelines. + +> Describe any automated processes that facilitate smoother collaboration. +> For instance, explain how to run linting tools. No need to justify conventions; +> simply enumerate them. + +> For libraries, components, or frameworks, explain how to set up a local +> environment for development. Avoid detailing this in the 'Quick Guide' section. + +## License + +> Provide a link to the License. + +## Acknowledgements + +> Give credit to third-party libraries, tools, or individuals whose work is used +> or inspired your project. +``` + +--- + +> [!Note] +> Customize this template according to the specific needs of your projects. Add or remove sections +> based on the nature of each project. + + +[workflow-badges]: https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge + +## Further Reading + +For more detailed information on specific topics not covered in this README, consider exploring the +following articles: [Contributor's Handbook](./CONTRIBUTING_GUIDE.md) +and [Understanding Licenses](./LICENSE_GUIDE.md). diff --git a/pr-preview/pr-14/img/rts-logo.svg b/pr-preview/pr-14/img/rts-logo.svg new file mode 100644 index 0000000..3c0a1ea --- /dev/null +++ b/pr-preview/pr-14/img/rts-logo.svg @@ -0,0 +1,13 @@ + + + + + + + + + + + + + \ No newline at end of file diff --git a/pr-preview/pr-14/index.html b/pr-preview/pr-14/index.html new file mode 100644 index 0000000..a60db3f --- /dev/null +++ b/pr-preview/pr-14/index.html @@ -0,0 +1,36 @@ + + + + + RTS Development Guidelines + + + + + + + + +
+ + + + + + +