valvin
/
ttrss
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

update CONTRIBUTING.md (with weblate stuff, etc)

This commit is contained in:
Andrew Dolgov 2019-12-21 09:40:59 +03:00
parent 021757ad5c
commit 74ccf96d0b
1 changed files with 27 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
CONTRIBUTING.md
View File

@ -2,21 +2,36 @@
*(or: how I learned to post merge requests without crying myself to sleep)*
New user accounts on Gogs are not allowed to fork repositories because of spam. To get
initial fork access, do the following:
New user accounts on Gogs are not allowed to fork repositories because people
use development accounts to spam. To get initial fork access, do the following:
1. Register on the forums and on Gogs
2. Create a thread describing your proposed changes in Development subforum while
including your Gogs username
3. If your changes make sense to me, I'll update your repo limit and you'll be able to
fork things and file pull requests
1. Register on the forums and on [Gogs](https://git.tt-rss.org);
2. Create a thread describing your proposed changes in [Development subforum](https://community.tt-rss.org/c/tiny-tiny-rss/development)
while including your Gogs username;
3. You'll be given proper access and will be able to fork repositories and file PRs, etc;
If you already have a fully functional Gogs account it works pretty much like Github:
1. Fork the repository you're interested in
2. Do the needful
3. File a pull request with your changes against master branch
1. Fork the repository you're interested in;
2. Do the needful;
3. File a pull request with your changes against master branch;
That's it. If you have any other questions, see this forum thread:
That's it. If you have any other questions, see this [forum thread](https://discourse.tt-rss.org/t/how-to-contribute-code-via-pull-requests-on-git-tt-rss-org/1850).
https://discourse.tt-rss.org/t/how-to-contribute-code-via-pull-requests-on-git-tt-rss-org/1850
If you don't want to deal with the above, you can also clone one of the repositories
locally, do the needful, and post resulting patches on the [forums](https://community.tt-rss.org/c/tiny-tiny-rss/development).
Please don't inline patches in forum posts, attach files instead (``.patch`` or ``.diff`` file
extensions should work).
## Contributing translations
Believe it or not, people also spam using Weblate. Therefore, there's some minor
jumping through hoops involved here:
1. Register on Weblate / forums;
2. Post in the [Weblate discussion thread](https://community.tt-rss.org/t/easier-translations-with-weblate/1680) on the forum, ask to be added to a project
you're interested in;
3. You'll be given proper access rights and will be able to edit translations.
That's it. If the language you're interested is not available yet, ask and we'll add it;