|
|
@@ -2,8 +2,24 @@
|
|
|
|
|
|
## What and how to contribute
|
|
|
|
|
|
-Please submit a pull request or create an issue to add a new language to the list. We are looking for language implementations that are either actively maintained or largely "done". The VM, bytecode compiler, and standard library (if any) must have a free (*libre*) license. They may have optional add-ons with any license. A Datalog implementation must be able to parse Datalog source code; it must not be just an [EDSL](https://en.wikipedia.org/wiki/Domain-specific_language#External_and_Embedded_Domain_Specific_Languages).
|
|
|
+Please submit a pull request or create an issue to add a new language to the list.
|
|
|
+We are looking for language implementations that are either actively maintained or largely "done".
|
|
|
+The VM, bytecode compiler, and standard library (if any) must have a free (*libre*) license.
|
|
|
+They may have optional add-ons with any license.
|
|
|
+A Datalog implementation must be able to parse Datalog source code;
|
|
|
+it must not be just an [EDSL](https://en.wikipedia.org/wiki/Domain-specific_language#External_and_Embedded_Domain_Specific_Languages).
|
|
|
|
|
|
## Do not edit `README.md` directly
|
|
|
|
|
|
-`README.md` is automatically generated from `README.md.jinja2` and the data in [`data/projects.toml`](data/projects.toml). Do not edit `README.md` directly. To add a project or update a project's information, edit `data/projects.toml`. Edit `README.md.njk` to change information not derived from `data/projects.toml`.
|
|
|
+`README.md` is automatically generated from `README.md.jinja2` and the data in [`data/projects.toml`](data/projects.toml).
|
|
|
+Do not edit `README.md` directly.
|
|
|
+To add a project or update a project's information, edit `data/projects.toml`.
|
|
|
+Edit `README.md.njk` to change information not derived from `data/projects.toml`.
|
|
|
+
|
|
|
+## Descriptions
|
|
|
+
|
|
|
+Avoid marketing language in descriptions.
|
|
|
+You are encouraged to list a few of the project's cool standout features in the description,
|
|
|
+but don't call the project itself "fast" (relative to what?) or "revolutionary" (a matter of opinion).
|
|
|
+Write without adjectives when possible.
|
|
|
+If the project is faster than most implementations of the same language, say that.
|