diff options
author | David Robillard <d@drobilla.net> | 2014-11-21 01:12:26 -0500 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2014-11-21 01:12:26 -0500 |
commit | d38c4094a1aef8be93218adeefe66b20308d96e3 (patch) | |
tree | 7f1d451dd1edade63567504c67b61bbc24d7c683 /themes/lv2/CONTRIBUTING.md | |
download | lv2site-d38c4094a1aef8be93218adeefe66b20308d96e3.tar.xz |
Initial website Markdown conversion.
Diffstat (limited to 'themes/lv2/CONTRIBUTING.md')
-rw-r--r-- | themes/lv2/CONTRIBUTING.md | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/themes/lv2/CONTRIBUTING.md b/themes/lv2/CONTRIBUTING.md new file mode 100644 index 0000000..1cb4d5d --- /dev/null +++ b/themes/lv2/CONTRIBUTING.md @@ -0,0 +1,16 @@ +# Guidelines For Contributing + +- Create a new git branch specific to your change, as opposed to making your commits in the master branch. +- Don't put multiple fixes/features in the same branch / pull request. +- Give a proper description in your pull request of what you're trying to fix. +- First line of your commit message should start with present-tense verb, be 50 characters or less, and include the +relevant issue number(s) if applicable. Example: _Ensure proper PLUGIN_PATH behavior. Refs #428._ If the commit completely +fixes an existing issue or request on the tracker, please use `Fixes #585` or `Fix #585` syntax (so the relevant issue is automatically closed +upon PR merge). +- Make sure that new features are configurable using a theme variable (eg. `DISPLAY_CHUCKNORRIS_ADVICE`). Should default to +_False_, so users will not get any surprises when upgrading. +- If you introduce new theme variables, new behaviour or changes from the default Pelican behaviour, make sure you make +mention of it in the [README](README.md) +- Make sure changes do not break backwards compatibility, especially with regards to settings. +- Only changes that stand to benefit a majority of users or use cases are suitable for contributing back to the main repository. For tweaks that are likely specific to your site or likings, try using `CUSTOM_CSS`. + - If doing so would require a CSS selector that isn't supported by the theme, create a patch that adds the necessary CSS selector, not the CSS tweak. |