-
Notifications
You must be signed in to change notification settings - Fork 106
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update contribution guide #636
Conversation
Codecov Report
@@ Coverage Diff @@
## master #636 +/- ##
=======================================
Coverage 90.54% 90.54%
=======================================
Files 56 56
Lines 2698 2698
Branches 355 355
=======================================
Hits 2443 2443
Misses 197 197
Partials 58 58 Continue to review full report at Codecov.
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good, just a few small suggestions. Let me know when you are ready and I'm happy to mark it approved.
docs/contributing.rst
Outdated
@@ -132,6 +132,11 @@ another ``psql`` commands:: | |||
|
|||
For additional ``psql`` commands see ``man psql``. | |||
|
|||
To run cron job in vagrant container run these commands:: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
To run cron job in vagrant container run these commands:: | |
To run the cron job in the Vagrant guest, run these commands:: |
docs/contributing.rst
Outdated
To run cron job in vagrant container run these commands:: | ||
|
||
$ workon anitya | ||
$ ANITYA_WEB_CONFIG=/home/vagrant/anitya.toml python files/anitya_cron.py |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You could make it so that the workon anitya
adds ANITYA_WEB_CONFIG=/home/vagrant/anitya.toml
to the environment automatically.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I added it to bashrc
for vagrant guest.
docs/contributing.rst
Outdated
@@ -209,17 +214,25 @@ If you are a maintainer and wish to make a release, follow these steps: | |||
1. Change the version in ``anitya.__init__.__version__``. This is used to set the | |||
version in the documentation project and the setup.py file. | |||
|
|||
2. Generate the changelog by running ``towncrier``. | |||
2. Add any missing news fragment to ``news`` folder |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
2. Add any missing news fragment to ``news`` folder | |
2. Add any missing news fragments to the ``news`` folder. |
docs/contributing.rst
Outdated
3. Generate the changelog by running ``towncrier``. | ||
|
||
.. note:: | ||
If you added any news fragment in previous step you could see ``towncrier`` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If you added any news fragment in previous step you could see ``towncrier`` | |
If you added any news fragment in the previous step, you might see ``towncrier`` |
docs/contributing.rst
Outdated
|
||
.. note:: | ||
If you added any news fragment in previous step you could see ``towncrier`` | ||
complaining about removing them, because these are not commited in git. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
complaining about removing them, because these are not commited in git. | |
complaining about removing them, because they are not committed in git. |
docs/contributing.rst
Outdated
.. note:: | ||
If you added any news fragment in previous step you could see ``towncrier`` | ||
complaining about removing them, because these are not commited in git. | ||
Just ignore this and remove them manually, release notes will be generated |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just ignore this and remove them manually, release notes will be generated | |
Just ignore this and remove them manually; release notes will be generated |
|
||
4. Tag a release with ``git tag -s v<version>``. | ||
5. Tag a release with ``git tag -s <version>``. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+100
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM, but I recommend squashing the commits before merging.
squash |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This one also fails lint.
The PR fixing the lint issue was merged, so I'm doing a rebase to fix also this PR. |
When doing first release using towncrier I noticed some missing things in contribution guide.
So this PR is addressing them.