CONTRIBUTING.md 2.5 KB
Newer Older
1
2
# Contributing

3
4
5
6
Contributions are welcome! Every of your contributions to the content (mainly apps.csv and games.csv) has to be licensed under CC-BY-SA-4.0. 

It is recommended to edit the lists in LibreOffice Calc.

Peter's avatar
Peter committed
7
[TBD: Explain CSV import (, as seperator) and efficient editing (highlight B2 and click View > Freeze Rows and Columns")]
8

9
10
For apps.csv, please add apps below existing apps.

11
12
## Easy tasks, great for first-time contributions:

13
### Check if apps are available on Arch, Mobian, postmarketOS or Flathub. You can easily do so by using [Repology](https://repology.org/).
Peter's avatar
Peter committed
14
15
* If you are running another distribution, feel free to add an extra column for it and start filling it!
* Please note: While this is important, a future iteration of this list will likely just include a repology badge, so don't invest all of your time into this!
16

17
18
### Add a new app
* Candidates are listed on [apps-to-be-added.md]().
19

20
### Games to add to the game list (make sure to put it in in alphabetical order)
Peter's avatar
Peter committed
21
22
23
24
25
* AisleRiot (see https://forums.puri.sm/t/list-of-apps-that-fit-and-function-well-post-them-here/11361/7)
* Taquin (https://forums.puri.sm/t/list-of-apps-that-fit-and-function-well-post-them-here/11361/7)
* Reversi (https://forums.puri.sm/t/list-of-apps-that-fit-and-function-well-post-them-here/11361/13) 
* Gnubik (https://forums.puri.sm/t/list-of-apps-that-fit-and-function-well-post-them-here/11361/26)
* Foobillardplus (https://github.com/alrusdi/foobillardplus | http://foobillardplus.sourceforge.net/ | https://sourceforge.net/projects/foobillardplus/ ~ https://pkgs.org/search/?q=foobillardplus; https://pkgs.org/search/?q=foobillardplus)
26
   
27
## Further content maintenance tasks:
28
29
* ~~Check and remove further apps that are no longer available (e.g. source code gone) by copying them to archive.csv.~~
* ~~Add games or Apps from "other games.csv" or "other apps.csv".~~
30
* fix typos :D
31
32
33
34
35
36
37
38
39
40
* check links again
* transition "Category" over to Freedesktop [categories](https://specifications.freedesktop.org/menu-spec/latest/apa.html) and [Additional categories](https://specifications.freedesktop.org/menu-spec/latest/apas02.html). _feels painful, therefore not yet started._
* ~~transition "License" over to [SPDX identifiers](https://spdx.org/licenses/)~~
* add URLs for appstream-files (per project) _in progress_

## Design tasks: 
* Make AppStream Links work.
* Improve mobile design generally.
* Implement a way to display screenshots and or app logos.
* Implement a form with the necessary fields for apps.csv generation for easier email submission.