Difference between revisions of "How to Help"

From F-Droid
Jump to: navigation, search
(moved to https://f-droid.org/docs/How_to_Help)
 
Line 1: Line 1:
{{Languages}}
+
moved to https://f-droid.org/docs/How_to_Help
The project is entirely developed and maintained by volunteers. You can help in the following ways:
+
 
+
== Follow our work ==
+
 
+
The [[Feeds]] page lists the various sites that we work on.
+
 
+
== Report problems ==
+
 
+
If you experience problems with the site or client software, you can report them in the [https://gitlab.com/u/fdroid issue tracker] ([https://f-droid.org/repository/issues old issue tracker]), discuss them in the [https://f-droid.org/forums Forum] or on IRC ([https://webchat.freenode.net/?randomnick=1&channels=%23fdroid&uio=MT1mYWxzZSYyPXRydWUmND10cnVlJjk9dHJ1ZSYxMD10cnVlJjEyPXRydWU84 #fdroid on freenode]). Take a look at the [[Repository Maintenance]] page to see how you can help keeping apps and their metadata up to date.
+
 
+
If you are reporting an issue with the client, [[Client Bug Reports|check out these pointers]] to make sure we have the best chance of reproducing and fixing your issue.
+
 
+
== Submit applications ==
+
 
+
If you see an application missing from the repository (after reading the [[Inclusion Policy]]), please feel free to submit it via the dedicated [http://f-droid.org/forums/forum/submission-queue Submission Queue] section of the forum.
+
 
+
Metadata may already be found there but it can always be improved. Often developers don't mark their releases well: you can ask them to use tags via an issue on their tracker, which will allow us to use an automatic check for new versions (and you can suggest a donation method while you're about it!). Another common task is the comparison of included libraries with official versions.
+
 
+
If you have the technical skills required, you can also put together the relevant metadata and submit a merge request to the git repository, which should speed up the inclusion of the application. See the [https://f-droid.org/forums/topic/adding-apps-with-git/ sticky thread] at the top of that forum for more information.
+
 
+
== Update apps ==
+
 
+
The procedure for updating apps is similar to adding new apps: changes are applied to the metadata in the fdroiddata git repository. You'll need to already be familiar with adding new apps. Even though it should take much less time to update an app one should still be cautious. Follow the steps in the [[How_to_update_an_app|update guide]] to minimize the risk of messing up and don't be afraid to ask for help!
+
 
+
== Translate ==
+
 
+
The client application is available in many languages, but if yours is not included, or if it needs updating or improving, follow [https://hosted.weblate.org/engage/f-droid/ these instructions].
+
 
+
The web site, this wiki , and app descriptions are not covered yet, but will be included in the same system at a later date.
+
 
+
There's a [http://f-droid.org/forums/forum/translation/ dedicated forum section] for discussions about translation.
+
 
+
== Help with development ==
+
 
+
There are three git repositories hosted at Gitlab, as follows:
+
 
+
* Android client application - [https://gitlab.com/fdroid/fdroidclient https://gitlab.com/fdroid/fdroidclient] - Issues suitable for new contributors are tagged [https://gitlab.com/fdroid/fdroidclient/issues?label_name=help-wanted help-wanted]
+
* Server tools, for the tools for running a repository and building/installing applications locally  - [https://gitlab.com/fdroid/fdroidserver https://gitlab.com/fdroid/fdroidserver]
+
* Metadata files for applications in the main F-Droid repository - [https://gitlab.com/fdroid/fdroiddata https://gitlab.com/fdroid/fdroiddata]
+
 
+
The easiest way to contribute to development is to make clones of these projects and submit merge requests. If you are making large changes, it would be good to discuss them on IRC or in the forum first, to ensure they fit with the direction of the project, and do not clash with or duplicate work already in development.
+
 
+
For working with the server project, it's a good idea to read [http://f-droid.org/manual/ the manual] and learn our [[git workflow]].
+
 
+
== Design ==
+
We'd love any contributions to make the project prettier and easier to use. If you are good at writing we are working on improving the [[Home page]]. If you can design mockups the client developers could use your help. There is a repo for mockups [http://gitorious.org/fdroidclient-mockups/fdroidclient-mockups here] or you can upload image files via the sidebar.
+

Latest revision as of 12:30, 6 September 2017

moved to https://f-droid.org/docs/How_to_Help