Skip to content

Commit 7f3cb01

Browse files
alexAubintituspijeanzamenturOniriCorpe
authored
Official app catalog policy (YunoHost#2559)
* Official app catalog policy * Update pages/06.contribute/10.packaging_apps/90.policy/policy.md * Apply suggestions from titus review Co-authored-by: tituspijean <titus+yunohost@pijean.ovh> * Update pages/06.contribute/10.packaging_apps/90.policy/policy.md * Let's stay open to debates or to better explaining our POV Co-authored-by: ljf (zamentur) <zamentur@users.noreply.github.com> --------- Co-authored-by: tituspijean <titus+yunohost@pijean.ovh> Co-authored-by: ljf (zamentur) <zamentur@users.noreply.github.com> Co-authored-by: OniriCorpe <oniricorpe@yunohost.org>
1 parent 2191ea5 commit 7f3cb01

File tree

4 files changed

+62
-17
lines changed

4 files changed

+62
-17
lines changed

pages/05.community/20.faq/faq.fr.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,17 @@ Nous ne donnons pas de calendrier.
9191
Nous sommes une poignée de volontaires travaillant sur notre temps libre pour maintenir et développer YunoHost. Nous n'avons pas de responsable produit ou de chef de projet, nous ne sommes pas une entreprise. Nous faisons ce que nous pouvons, parce que nous aimons ce logiciel, quand nous le pouvons.
9292

9393
Si vous souhaitez vraiment voir une fonctionnalité codée ou documentée, ou une application packagée, [envisagez de contributer](/contribute)! Nous adorerions vous aider à vous mettre en selle.
94+
95+
### What is YunoHost's policy regarding the apps included in the official catalog ?
96+
97+
See [this page](/packaging_policy)
98+
99+
### Why won't you include [feature X] ?
100+
101+
YunoHost is primarily designed for not-so-tech-savvy users and aims to remain relatively simple in terms of UI/UX. At the same time, the project has limited time and energy available to be maintained and developed. Therefore we may lower the priority of features, or refuse entirely the inclusion of features, based on the criteria that they:
102+
103+
- would only be meaningful for advanced / power-users stuff which is out of the scope of the project ;
104+
- would introduce too much UI/UX bloat ;
105+
- would only cover unrealistic threat models ;
106+
- would be there only to satisfy purists ;
107+
- or overall would not be worth it in terms of development/maintenance time/energy for what it brings to the project.

pages/05.community/20.faq/faq.md

Lines changed: 1 addition & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -93,22 +93,7 @@ If you really want to have a feature implemented or documented, or an app packag
9393

9494
### What is YunoHost's policy regarding the apps included in the official catalog ?
9595

96-
The rule of thumb is that we only include software licensed under a free-software license in the official app catalog.
97-
98-
However, as YunoHost evolved, some gray-cases appeared with softwares that would be relevant for YunoHost's goal and match its spirit, while not being strictly-speaking free-software. Situations such as:
99-
100-
- software promoting the use of centralized services, though precisely to avoid their direct usage ;
101-
- software relying on non-free dependencies or assets ;
102-
- "new" post-open-source / ethical-yet-not-free licenses such as the [ACSL](https://anticapitalist.software/), the [HL3](https://firstdonoharm.dev/) or the [CoopCycle License](https://github.com/coopcycle/coopcycle-web/blob/master/LICENSE) ;
103-
- "open-core" models, trademark clauses, or business-related license clauses (such as the BSL) which are meant to ensure the project's sustainability while still remaining ethical.
104-
105-
While we believe free software principles are an essential footstep towards [YunoHost's goal](#what-s-yunohost-goal), we believe they are a means and not an end. We reject the purist vision according to which software is either free or proprietary, and the flawed premise that technology is fundamentally neutral. We believe that ethical software and technology can and should exist beyond the definition of free software layed 40 years ago (see also: [Freedom isn't Free](https://logicmag.io/failure/freedom-isnt-free/) and [Post-Open Source](https://www.boringcactus.com/2020/08/13/post-open-source.html)).
106-
107-
The project therefore allows the inclusion inside the official app catalog, ***on a case-by-case basis***, of apps which does not qualify as "free software", yet considered to be ethical and worthy of interest for [YunoHost's goal](#what-s-yunohost-goal). Such apps are tagged in the catalog, such that an explicit message displayed before their installation.
108-
109-
If you notice an app is missing such a tag/disclaimer, feel free to open a discussion or pull requet on [the app catalog](https://github.com/YunoHost/apps/).
110-
111-
If you run YunoHost for your business, you are responsible for doing your due diligence by checking the licenses of the software you want to install on your server.
96+
See [this page](/packaging_policy)
11297

11398
### Why won't you include [feature X] ?
11499

pages/06.contribute/10.packaging_apps/50.publishing/publishing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ routes:
99

1010
The official YunoHost's app catalog is maintained [in this repository](https://github.com/YunoHost/apps/), in particular [the `apps.toml` file](https://github.com/YunoHost/apps/blob/master/apps.toml).
1111

12-
For your app to be made available to everybody, you should make a pull request that adds your app inside the `apps.toml` (see the [detailed instructions in the README](https://github.com/YunoHost/apps/#how-to-add-your-app-to-the-application-catalog))
12+
For your app to be made available to everybody, you should make a pull request that adds your app inside the `apps.toml` (see the [detailed instructions in the README](https://github.com/YunoHost/apps/#how-to-add-your-app-to-the-application-catalog)). Before doing so, please make sure to check that your app is compatible with [the official app catalog policy](/packaging_policy).
1313

1414
Note that the "real" catalog used by YunoHost servers is <https://app.yunohost.org/default/v3/apps.json> which is rebuilt every 4 hours.
1515

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: YunoHost's policy regarding the apps included in the official catalog
3+
template: docs
4+
taxonomy:
5+
category: docs
6+
routes:
7+
default: '/packaging_policy'
8+
---
9+
10+
### License
11+
12+
The rule of thumb is that we only include software licensed under a free-software license in the official app catalog.
13+
14+
As YunoHost grew, some gray area cases appeared with software that would be relevant for [YunoHost's goal](#what-s-yunohost-goal) and match its spirit, while not being strictly-speaking free-software. These applications may be:
15+
16+
- promoting the use of centralized services, though precisely to avoid their direct usage ;
17+
- relying on non-free dependencies or assets ;
18+
- released under "new" post-open-source or ethical-yet-not-free licenses such as the [ACSL](https://anticapitalist.software/), the [HL3](https://firstdonoharm.dev/) or the [CoopCycle License](https://github.com/coopcycle/coopcycle-web/blob/master/LICENSE) ;
19+
- released under "open-core" models, trademark clauses, or business-related license clauses (such as the BSL) which are meant to ensure the project's sustainability while remaining ethical.
20+
21+
While we believe free software principles are an essential footstep towards [YunoHost's goal](#what-s-yunohost-goal), we believe they are a means and not an end. We reject the purist vision according to which software is either free or proprietary, and the flawed premise that technology is fundamentally neutral. We believe that ethical software and technology can and should exist beyond the definition of free software layed 40 years ago (see also: [Freedom isn't Free](https://logicmag.io/failure/freedom-isnt-free/) and [Post-Open Source](https://www.boringcactus.com/2020/08/13/post-open-source.html)).
22+
23+
The project therefore allows the inclusion inside the official app catalog, ***on a case-by-case basis***, of apps which does not qualify as "free software", yet considered to be ethical and worthy of interest for [YunoHost's goal](#what-s-yunohost-goal). Such apps are tagged in the catalog, such that an explicit message displayed before their installation.
24+
25+
If you notice an app is missing such a tag/disclaimer, feel free to open a discussion or pull requet on [the app catalog](https://github.com/YunoHost/apps/).
26+
27+
If you run YunoHost for your business, you are responsible for doing your due diligence by checking the licenses of the software you want to install on your server.
28+
29+
### Nature of the app
30+
31+
In addition, the YunoHost team decided to not include apps in the official catalog if they:
32+
- are overly complex to deploy or resource-hungry compared to their features ;
33+
- only apply to super niche use cases ;
34+
- promote cryptocurrencies ;
35+
- promote AI for purposes deemed futile compared to the ecological and sociological costs involved behind the scenes ;
36+
- promote shady activities such as tracking/stalking people.
37+
38+
The team may make exceptions to these criteria on a case-by-case basis, on its own volition. The team may also amend this list with other criteria in the future.
39+
40+
### What to do if you're not happy with these criterias
41+
42+
These editorial choices do not mean that apps infringing them cannot be created, merely that they won't be included in the official catalog.
43+
You are free to:
44+
- [Develop your own application packages](/packaging_apps) (though support may be limited due to aforementioned criteria)
45+
- Manually install any application by using `yunohost app install <url_to_git_repo_ynh>`
46+
- Create and add a custom catalog source within `/etc/yunohost/apps_catalog.yml`

0 commit comments

Comments
 (0)