Hi there! We're thrilled that you'd like to contribute to the gcweb-jekyll theme. Your help is essential for keeping it great.
The gcweb-jekyll theme is an open source project supported by the efforts of an entire community and built one contribution at a time by users like you. We'd love for you to get involved. Whatever your level of skill or however much time you can give, your contribution is greatly appreciated. There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests, helping other users by commenting on issues, or writing code which can be incorporated into the gcweb-jekyll theme itself.
Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open source project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests.
Think you found a bug? Please check the list of open issues to see if your bug has already been reported. If it hasn't please submit a new issue.
Here are a few tips for writing great bug reports:
- Describe the specific problem (e.g., "widget doesn't turn clockwise" versus "getting an error")
- Include the steps to reproduce the bug, what you expected to happen, and what happened instead
- Check that you are using the latest version of the project and its dependencies
- Include what version of the project your using, as well as any relevant dependencies
- Only include one bug per issue. If you have discovered two bugs, please file two issues
- Even if you don't know how to fix the bug, including a failing test may help others track it down
Do not post any security issues on the public repository! See SECURITY.md
If you find yourself wishing for a feature that doesn't exist in the gcweb-jekyll theme, you are probably not alone. There are bound to be others out there with similar needs. Many of the features that the gcweb-jekyll theme has today have been added because the community saw the need.
Feature requests are welcome. But take a moment to find out whether your idea fits with the scope and goals of the project. It's up to you to make a strong case to convince the project's developers of the merits of this feature. Please provide as much detail and context as possible, including describing the problem you're trying to solve.
Open an issue which describes the feature you would like to see, why you want it, how it should work, etc.
We'd love for you to contribute to the project. Unsure where to begin contributing to the gcweb-jekyll theme? You can start by looking through these "good first issue" and "help wanted" issues:
- Good first issues - issues which should only require a few lines of code and a test or two
- Help wanted issues - issues which may be a bit more involved, but are specifically seeking community contributions
p.s. Feel free to ask for help; everyone is a beginner at first 😺
Here's a few general guidelines for proposing changes:
- If you are making visual changes, include a screenshot of what the affected element looks like, both before and after.
- Follow the Jekyll style guide.
- If you are changing any user-facing functionality, please be sure to update the documentation
- Each pull request should implement one feature or bug fix. If you want to add or fix more than one thing, submit more than one pull request
- Do not commit changes to files that are irrelevant to your feature or bug fix
- Don't bump the version number in your pull request (it will be bumped prior to release)
- Write a good commit message
At a high level, the process for proposing changes is:
- Fork and clone the project
- Configure and install the dependencies:
script/bootstrap - Make sure the tests pass on your machine:
script/cibuild - Create a new branch:
git checkout -b my-branch-name - Make your one commit (i.e. Initial commit)
- Push to your fork and submit a pull request
- Make your changes add tests, and make sure the tests still pass
- Pat your self on the back and wait for your pull request to be reviewed and merged
Interesting in submitting your first Pull Request? It's easy! You can learn how from this free series How to Contribute to an Open Source Project on GitHub
script/bootstrap
script/cibuild
This project is governed by the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code.
If you'd like to preview the theme locally (for example, in the process of proposing a change):
- Clone down the theme's repository (
git clone https://github.com/wet-boew/gcweb-jekyll) cdinto the theme's directory- Run
script/bootstrapto install the necessary dependencies - Run
bundle exec jekyll serveto start the preview server - Visit
localhost:4000in your browser to preview the theme
The theme contains a minimal test suite, to ensure a site with the theme would build successfully. To run the tests, simply run script/cibuild. You'll need to run script/bootstrap one before the test script will work.
(French version will be available shortly)
Lorsque vous contribuez, veuillez également publier des commentaires et discuter des modifications que vous souhaitez apporter par l'entremise des enjeux (Issues).
N'hésitez pas à proposer des modifications en créant des demandes de tirage (Pull Requests). Si vous n'avez pas accès au mode de rédaction, la modification d'un fichier créera une copie (Fork) de ce projet afin que vous puissiez enregistrer les modifications que vous proposez. Le fait de proposer une modification à un fichier l'écrira dans une nouvelle branche dans votre copie (Fork), de sorte que vous puissiez envoyer une demande de tirage (Pull Request).
Si c'est la première fois que vous contribuez à GitHub, ne vous en faites pas! Faites-nous part de vos questions.
Ne publiez aucun problème de sécurité sur le dépôt publique! Voir SECURITY.md