@@ -5,162 +5,4 @@ Contributing
5
5
Contributions are welcome, and they are greatly appreciated! Every
6
6
little bit helps, and credit will always be given.
7
7
8
- You can contribute in many ways:
9
-
10
- Types of Contributions
11
- **********************
12
-
13
- Report Bugs
14
- ===========
15
-
16
- Report bugs at https://github.com/nephila/djangocms-page-meta/issues.
17
-
18
- If you are reporting a bug, please include:
19
-
20
- * Your operating system name and version.
21
- * Any details about your local setup that might be helpful in troubleshooting.
22
- * Detailed steps to reproduce the bug.
23
-
24
- Fix Bugs
25
- ========
26
-
27
- Look through the GitHub issues for bugs. Anything tagged with "bug"
28
- is open to whoever wants to implement it.
29
-
30
- Implement Features
31
- ==================
32
-
33
- Look through the GitHub issues for features. Anything tagged with "feature"
34
- is open to whoever wants to implement it.
35
-
36
- Write Documentation
37
- ===================
38
-
39
- djangocms-page-meta could always use more documentation, whether as part of the
40
- official djangocms-page-meta docs, in docstrings, or even on the web in blog posts,
41
- articles, and such.
42
-
43
- Submit Feedback
44
- ===============
45
-
46
- The best way to send feedback is to file an issue at https://github.com/nephila/djangocms-page-meta/issues.
47
-
48
- If you are proposing a feature:
49
-
50
- * Explain in detail how it would work.
51
- * Keep the scope as narrow as possible, to make it easier to implement.
52
- * Remember that this is a volunteer-driven project, and that contributions
53
- are welcome :)
54
-
55
- ************
56
- Get Started!
57
- ************
58
-
59
- Ready to contribute? Here's how to set up ``djangocms-page-meta `` for local development.
60
-
61
- 1. Fork the ``djangocms-page-meta `` repo on GitHub.
62
- 2. Clone your fork locally::
63
-
64
- $ git clone git@github.com:your_name_here/djangocms-page-meta.git
65
-
66
- 3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper
67
- installed, this is how you set up your fork for local development::
68
-
69
- $ mkvirtualenv djangocms-page-meta
70
- $ cd djangocms-page-meta/
71
- $ pip install -r requirements-test.txt
72
- $ pip install -e .
73
-
74
- 4. Create a branch for local development::
75
-
76
- $ git checkout -b name-of-your-bugfix-or-feature
77
-
78
- Now you can make your changes locally.
79
-
80
- 5. When you're done making changes, check that your changes pass flake8 and the
81
- tests, including testing other Python versions with tox::
82
-
83
- $ tox
84
-
85
- To get tox, pip install it into your virtualenv.
86
-
87
- 6. Commit your changes and push your branch to GitHub::
88
-
89
- $ git add .
90
- $ git commit -m "Your detailed description of your changes."
91
- $ git push origin name-of-your-bugfix-or-feature
92
-
93
- 7. Submit a pull request through the GitHub website.
94
-
95
- Development tips
96
- ----------------
97
-
98
- This project allows you to use `pre-commit <https://pre-commit.com/ >`_ to ensure an easy compliance
99
- to the project code styles.
100
-
101
- If you want to use it, install it globally (for example with ``pip3 install --user precommit ``,
102
- but check `installation instruction <https://pre-commit.com/#install >`_.
103
- When first cloning the project ensure you install the git hooks by running ``pre-commit install ``.
104
-
105
- From now on every commit will be checked against our code style.
106
-
107
- Check also the available tox environments with ``tox -l ``: the ones not marked with a python version number are tools
108
- to help you work on the project buy checking / formatting code style, running docs etc.
109
-
110
- Testing tips
111
- ----------------
112
- You can test your project using any specific combination of python, django and django cms.
113
-
114
- For example ``tox -py37-django30-cms37 `` runs the tests on python 3.7, Django 3.0 and django CMS 3.7.
115
-
116
-
117
- Pull Request Guidelines
118
- =======================
119
-
120
- Before you submit a pull request, check that it meets these guidelines:
121
-
122
- #. Pull request must be named with the following naming scheme:
123
-
124
- ``<type>/(<optional-task-type>-)<number>-description ``
125
-
126
- See below for available types.
127
-
128
- #. The pull request should include tests.
129
- #. If the pull request adds functionality, the docs should be updated.
130
- Documentation must be added in ``docs `` directory, and must include usage
131
- information for the end user.
132
- In case of public API method, add extended docstrings with full parameters
133
- description and usage example.
134
- #. Add a changes file in ``changes `` directory describing the contribution in
135
- one line. It will be added automatically to the history file upon release.
136
- File must be named as ``<issue-number>.<type> `` with type being:
137
-
138
- * ``.feature ``: For new features.
139
- * ``.bugfix ``: For bug fixes.
140
- * ``.doc ``: For documentation improvement.
141
- * ``.removal ``: For deprecation or removal of public API.
142
- * ``.misc ``: For general issues.
143
-
144
- Check `towncrier `_ documentation for more details.
145
-
146
- #. The pull request should work for all python / django / django CMS versions
147
- declared in tox.ini.
148
- Check the CI and make sure that the tests pass for all supported versions.
149
-
150
- Release a version
151
- =================
152
-
153
- #. Update authors file
154
- #. Merge ``develop `` on ``master `` branch
155
- #. Bump release via task: ``inv tag-release (major|minor|patch) ``
156
- #. Update changelog via towncrier: ``towncrier --yes ``
157
- #. Commit changelog with ``git commit --amend `` to merge with bumpversion commit
158
- #. Create tag ``git tag <version> ``
159
- #. Push tag to github
160
- #. Publish the release from the tags page
161
- #. If pipeline succeeds, push ``master ``
162
- #. Merge ``master `` back on ``develop ``
163
- #. Bump developement version via task: ``inv tag-dev -l (major|minor|patch) ``
164
- #. Push ``develop ``
165
-
166
- .. _towncrier : https://pypi.org/project/towncrier/#news-fragments
8
+ Please read the instructions `here <https://nephila.github.io/contributing/contributing >`_ to start contributing to `djangocms-page-meta `.
0 commit comments