Limit CONTRIBUTING.md to ~80cols, syntax

This commit is contained in:
Daniel Martí 2015-08-18 16:02:24 -07:00
parent d3a6a3767e
commit 9b82ba3e17

View file

@ -1,33 +1,70 @@
# Contributing to F-Droid # Contributing to F-Droid
Thanks so much for contributing to [F-Droid](https://f-droid.org)! Please take your time to read carefully through this document: Thanks so much for contributing to [F-Droid](https://f-droid.org)! Please take
your time to read carefully through this document:
## Issue Tracker ## Issue Tracker
Please note that the tracker is not for app submissions, use the [submission queue](https://f-droid.org/forums/forum/submission-queue/) instead.
For error reports please provide detailed system (e.g. Android version, used ROM, hardware specifications) and error information (e.g. What happened? When did it happen?) and provide the [logcat](https://developer.android.com/tools/help/logcat.html) -- either by file upload or by inclduing it with the appropriated [markdown](https://github.com/gitlabhq/gitlabhq/blob/master/doc/markdown/markdown.md). Please note that the tracker is not for app submissions, use the
[submission queue](https://f-droid.org/forums/forum/submission-queue/) instead.
For update/change requests, please make sure they meet our [inclusion policy](https://f-droid.org/wiki/page/Inclusion_Policy) and are not already handled by our [submission queue](https://f-droid.org/forums/forum/submission-queue/), are not [held](https://f-droid.org/forums/forum/submission-held/) for some reason or already [marked for an update](https://f-droid.org/wiki/page/Category:Apps_to_Update). Keep discussions to a minimum or use the forum instead. For error reports please provide detailed system (e.g. Android version, used
ROM, hardware specifications) and error information (e.g. What happened? When
did it happen?) and provide the [logcat](https://developer.android.com/tools/help/logcat.html)
-- either by file upload or by inclduing it with the appropriated
[markdown](https://github.com/gitlabhq/gitlabhq/blob/master/doc/markdown/markdown.md).
However, the easiest way to get an app included, updated or an error fixed is to provide the required metadata yourself by opening a merge request. For update/change requests, please make sure they meet our
[inclusion policy](https://f-droid.org/wiki/page/Inclusion_Policy) and are not already
handled by our [submission queue](https://f-droid.org/forums/forum/submission-queue/),
are not [held](https://f-droid.org/forums/forum/submission-held/) for some reason or already
[marked for an update](https://f-droid.org/wiki/page/Category:Apps_to_Update).
Keep discussions to a minimum or use the forum instead.
However, the easiest way to get an app included, updated or an error fixed is
to provide the required metadata yourself by opening a merge request.
## Merge Requests ## Merge Requests
Please read through the [inclusion howto](https://f-droid.org/wiki/page/Inclusion_How-To), the [inclusion policy](https://f-droid.org/wiki/page/Inclusion_Policy) and our [fdroid manual](https://f-droid.org/manual/fdroid.html).
This section includes some information on the fdroidserver repository as the tools contained in there can be used standalone to check and build local metadata files. Please read through the [inclusion howto](https://f-droid.org/wiki/page/Inclusion_How-To),
the [inclusion policy](https://f-droid.org/wiki/page/Inclusion_Policy) and our
[fdroid manual](https://f-droid.org/manual/fdroid.html).
This section includes some information on the fdroidserver repository as the
tools contained in there can be used standalone to check and build local
metadata files.
### Setting up fdroidserver and build tools ### Setting up fdroidserver and build tools
* Follow the instructions in [the manual](https://f-droid.org/manual)
* Follow the instructions in [the manual](https://f-droid.org/manual).
### Setting up fdroiddata and submitting apps ### Setting up fdroiddata and submitting apps
* [Register on GitLab](http://gitlab.com) * [Register on GitLab](http://gitlab.com)
* Visit and fork the [fdroiddata repository](https://gitlab.com/fdroid/fdroiddata/).
* Clone your fdroiddata fork. * Visit and fork the [fdroiddata repository](https://gitlab.com/fdroid/fdroiddata/)
* Copy fdroiddata/metadata/template or fdroiddata/metadata/template-minimal to fdroiddata/metadata/app.id.txt .
* Update metadata/app.id.txt according to the [manual](https://f-droid.org/manual/html_node/Metadata.html). * Clone your fdroiddata fork
* Copy fdroiddata/metadata/template or fdroiddata/metadata/template-minimal to
fdroiddata/metadata/app.id.txt
* Update metadata/app.id.txt according to the [manual](https://f-droid.org/manual/html_node/Metadata.html)
* If you have fdroidserver installed: * If you have fdroidserver installed:
* Copy and adjust fdroidserver/examples/config.py to fdroiddata/config.py .
* Instead of copying a template you can run `fdroid import -u github-url` if the app is hosted on GitHub. * Copy and adjust fdroidserver/examples/config.py to fdroiddata/config.py
* Run `fdroid checkupdates app.id`, `fdroid rewritemeta app.id` and `fdroid build -v -t -l app.id` before opening a merge request!
* Use `git add`, `git commit` and `git push` to update your fork on GitLab. Please squash multiple commits into a single one per app. It's a good style to use a separate branch for each app and prefix commit messages with "Appname:". For this you might also want to look at the `fd-commit` command in the server repo. * Instead of copying a template you can run `fdroid import -u github-url` if
* Open a merge request via GitLab. the app is hosted on GitHub
* Run `fdroid checkupdates app.id`, `fdroid rewritemeta app.id` and `fdroid
build -v -t -l app.id` before opening a merge request!
* Use `git add`, `git commit` and `git push` to update your fork on GitLab.
Please squash multiple commits into a single one per app. It's a good style
to use a separate branch for each app and prefix commit messages with
"Appname:". For this you might also want to look at the `fd-commit` command
in the server repo
* Open a merge request via GitLab