The definitive list of the best of (consumer facing) open source.
Consolidated contributing and guidelines for simplicity
Lucasc6513eeb00fd
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.mdindex 136b50f..2cb9015 100644--- a/.github/CONTRIBUTING.md+++ b/.github/CONTRIBUTING.md@@ -1,4 +1,3 @@-# Contributing GuidelinesPlease note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project, you agree to abide by its terms.@@ -8,9 +7,10 @@ Please note that this project is released with a [Contributor Code of Conduct](C- [Conventions](#conventions)- [Guidelines](#guidelines)- [How To Contribute](#how-to-contribute)+- [Submission Guidelines](#submission-guidelines)## A Quick Note-The scale of what this project is attempting to accomplish is one that can only be done collectively. All contributions are highly valued. For submission guidelines on projects, please consult the [submission guidelines](/.github/GUIDELINES.md)+The scale of what this project is attempting to accomplish is one that can only be done collectively. All contributions are highly valued.>[!IMPORTANT]>When possible, please edit the file directly and start a pull request instead of raising an issue. DO NOT EDIT THE README. Edit applications.json.@@ -18,7 +18,7 @@ The scale of what this project is attempting to accomplish is one that can only## Our AI PolicyI'm not necessarily against AI. I don't like the mass plagiarism LLM's were built on and their regurgative nature, but regardless, it's clear AI isn't going anywhere. I mean I use AI all the time... as a tool. And that's the key. LLM's are incredible, but there are limitations and it's important we don't forget that.-If your project uses AI as a tool, cool. Humans need to be architecting code structure, dependencies to use, etc. I don't really care if AI is writing mundane code though as long as it's being supervised and is being integrated in a way where it isn't slop.+If your project uses AI as a tool, cool. I don't really care if AI is writing code as long as it's being supervised and is being integrated in a way where it isn't slop.If your project is vibe-coded, it will not be allowed on this list. How will I know? AI created interfaces are rather easy to spot. The use of AGENTS.md and Claude in your contributor list are also a telling signs.@@ -45,12 +45,8 @@ Open applications.json and copy the following at the end:""],"category": "",- "stars": 0,"flags": [],- "last_commit": "",- "language": "","license": "",- "homepage_url": ""}```@@ -62,4 +58,26 @@ Add the `name`, `repo_url`, `tags`, `platform(s)`, and `category`. Everything el- The pull request and commit should be simple. EX: Added `Name` to `category`- One pull request per new addition- If a project is in the grey zone for submission guidelines, include why it should be included.-- Proposals for new categories or the re-organization of existing categories must be discussed and approved via an issue prior to a pull request+- Proposals for new categories, re-organization of existing categories, or changes to the underlying list system (ex: generation code) must be discussed and approved via an issue prior to a pull request++# Submission Guidelines++This list is for projects that are _directly used_, not projects with the sole purpose of building another project. Development technologies like frameworks or databases are not allowed. _Enterprise systems_ like CRM or marketing are currently not allowed but may be considered once the core of the list is ironed out.++```Definitive-opensource``` has a **rigorous** vetting process that involves comprehensive research into a project.++We continously monitor projects on the list and will immediately remove projects that no longer fit the criteria.++## Criteria+To avoid the clutter trap that many other lists succumb to as they scale, only the best software is included. But "best" is relative. It's mostly guaged based on the following criteria - keep in mind that there can be exceptions.++Requirements with no exception:+- Must have 1k stars. The most fundamental requirement with no exceptions.+- Must have had a commit in the last year++## What is Open Source?+The project should abide by the [Open Source Definition (OSD)](https://opensource.org/osd).+The project's license should be an [OSI Approved License](https://opensource.org/licenses). If not, it should fall under the OSD.++## Projects Not Hosted on GitHub+Most major projects hosted elsewhere have GitHub mirrors. Blender's mirror has 14.7k stars, Krita's has 8k, Gimp has 5.3, etc. The star counts of those mirrors are used. In the rare case that the project does not have a GitHub mirror, other measures will be taken to analyze product popularity.diff --git a/.github/GUIDELINES.md b/.github/GUIDELINES.mddeleted file mode 100644index 4c51bfb..0000000--- a/.github/GUIDELINES.md+++ /dev/null@@ -1,78 +0,0 @@--# Submission Guidelines-This list is for projects that are _directly used_, not projects with the sole purpose of building another project. Development technologies like frameworks or databases are not allowed. _Enterprise systems_ like CRM or marketing are currently not allowed but may be considered once the core of the list is ironed out.--```Definitive-opensource``` has a **rigorous** vetting process that involves comprehensive research into a project.--We continously monitor projects on the list and will immediately remove projects that no longer fit the criteria.--## Criteria-To avoid the clutter trap that many other lists succumb to as they scale, only the best software is included. But "best" is relative. It's mostly guaged based on the following criteria - keep in mind that there can be exceptions.--```π``` - This requirement cannot be bypassed.--```β οΈ``` - Not a hard value: research based requirement--```β ``` - Open ended--```π``` - Just a note--### 1. Popularity-- ```π``` The minimum star count is 1k.-- ```π``` Projects with over 5000 stars are preferred.--### 2. A Foundation-- ```β οΈ``` A contributor count of 5. Quality is more important than quantity here. A small team can pass if they are solid and dedicated.-- ```β οΈ``` The project should have stable roots, as in no internal conflicts or major disagreements that impact development.--### 3. Activity-- ```π``` A commit in the last 6 months-- ```β οΈ``` The project should have consistent activity and development.--### 4. Future Proof-- ```β οΈ``` The project should have a clear roadmap or general path and the means to deliver this goal--### 5. Quality-- ```β ``` The project should be competent and decently good quality.--## What is Open Source?-The project should abide by the [Open Source Definition (OSD)](https://opensource.org/osd).-The project's license should be an [OSI Approved License](https://opensource.org/licenses). If not, it should fall under the OSD.--## Projects Not Hosted on GitHub-Most major projects hosted elsewhere have GitHub mirrors. Blender's mirror has 14.7k stars, Krita's has 8k, Gimp has 5.3, etc. The star counts of those mirrors are used. In the rare case that the project does not have a GitHub mirror, other measures will be taken to analyze product popularity.--## Examples--### 1. PearCleaner-- **Description:** A free, source-available and fair-code licensed mac app cleaner-- **Stars:** 4.2k-- **Contributors:** 7-- **Explanation:** On the surface PearCleaner woudn't fit with a relatively small amount of stars and just seven contributors. But research brings about the following conclusion: PearCleaner is one of two major app cleaners for MacOS - the other being the proprietary AppCleaner. Despite just 7 contributors, they have been continuously pushing updates on a ~two week interval. They have a solid roadmap for future updates and have been delivering on those promises.-- ```Result: β ```--### 2. Marktext-- **Description:** A simple and elegant markdown editor, available for Linux, macOS and Windows.-- **Stars:** 48.1k-- **Contributors:** 144-- **Explanation:** Every part of this project passes the test... except for the fact that it's abandoned. It's still insanely popular but hasn't had a commit in 7 months and the last release was two years ago.-- ```Result: π«```--### 3. Zed Editor-- **Description:** Code at the speed of thought β Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.-- **Stars:** 52.3k-- **Contributors:** 753-- **Explanation:** Just about any software on this scale will make it onto this list. Zed Editor has a massive user base, a massive team, a solid roadmap, and the means to execute on those promises well into the future.-- ```Result: β ```--### 4. AM-- **Description:** AppImage Package Manager: AppImage sandboxing, local and system installation, update all AppImages-- **Stars:** 618-- **Contributors:** 27-- **Explanation:** This is really tough one. The concept is extraordinary and it has a dedicated team working hard to bring their vision to reality. Even so, the project is fairly new and rough around the edges - and it falls behind on a hard-coded requirement: it has less than 1k stars. This goes into our prospective backlog for projects that just barely don't make it and will be monitored.-- ```Result: π§°```-----diff --git a/resources/dev/ARCHITECTURE.md b/resources/dev/ARCHITECTURE.mdindex 1373f37..6812267 100644--- a/resources/dev/ARCHITECTURE.md+++ b/resources/dev/ARCHITECTURE.md@@ -1,11 +1,12 @@# Architecture-Here's a look at how this list works.+Here's a look at how this list works. (Needs to be updated)# The List ItselfThe core of this list is powered by Python using UV and Ruff for linting and formatting.## README Generation+All applications are stored inside [`applications.json`](core/data/dynamic/applications.json). Categories are declared inside [`categories.json`](core/data/static/categories.json). Instead of a nested format with subcategories as on object of it's parent, we've given subcategories a `parent` attribute. There's also a [`tags.json`](core/data/static/tags.json). Instead of putting the emoji inside of the ```tags``` attribute in `applications.json`, the id is used, for example, `commercial` or `disruptive`.. These id's are mapped to their corresponding emoji for when the READMEs are generated and makes``applications.json``` more readable.The generation scripts are inside of the [`core/source/generation`](core/source/generation) directory. [`mainheader_generator.py`](core/source/generation/mainheader_generator.py) generates the very top header with the dynamic project count. Then, depending on the platform being generating, it inserts [`header.md`](core/components/header.md), [`macosheader.md`](core/components/macosheader.md), etc.@@ -17,4 +18,4 @@ The generation scripts are inside of the [`core/source/generation`](core/source/Lastly [`readme_generator.py`](core/source/generation/readme_generator.py) brings everything together, calling the other scripts to generate one main list, and more for several platforms.## Maintenence-[`applications.json`](core/data/dynamic/applications.json) stores a lot of information that the README does not display such as last commit, language, and license. These are for a future web version of the list that would pull data from the json file. [`stats_updator.py`](source/maintenance/stats_updator.py) runs every midnight and updates all application stats. Each application object in the json file also has a `flags` attribute. For example, the `custom-description` flag tells the stats_updator script to skip updating the description for that app. For more into on flags, consult the [`DOCS.md`](resources/DOCS.md)\ No newline at end of file+[`applications.json`](core/data/dynamic/applications.json) stores a lot of information that the README does not display such as last commit, language, and license. These are for a future web version of the list that would pull data from the json file. [`stats_updator.py`](source/maintenance/stats_updator.py) runs every midnight and updates all application stats. Each application object in the json file also has a `flags` attribute. For example, the `custom-description` flag tells the stats_updator script to skip updating the description for that app. For more into on flags, consult the [`DOCS.md`](resources/DOCS.md)