Skip to content

Commit

Permalink
Fixed a typo and adapted text as per community feedback
Browse files Browse the repository at this point in the history
  • Loading branch information
eduardo-rodrigues committed Oct 26, 2024
1 parent 64c5ac2 commit 1f05c7a
Showing 1 changed file with 3 additions and 2 deletions.
5 changes: 3 additions & 2 deletions projects/guidelines.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Any software library should strive to the following:
Avoid pre-existing trademarks for software products or services.
* **Licensing.** An open-source license should be attached to the software.
* **Installation.** Instructions for how to install the library should be trivial to find, and the installation procedure should be standard for (e.g., at least via pip if the programming language is Python).
* **Documentation.** The code should be suitable documented and a users guide (at least in the format of a “quick start”) should be highlighted. For small libraries a users guide may be provided in the repository README.
* **Documentation.** The code should be suitably documented and a users guide (at least in the format of a “quick start”) should be highlighted. For small libraries a users guide may be provided in the repository README.
* **Test suite.** Code should always be (comprehensively) tested. Test coverage is strongly encouraged and should be displayed on the repository for a straightforward verification of the level of testing implemented.
* **Open to contributors.** The repository should encourage contributions from the community and should never disable pull/merge requests on the developer platform (such as GitHub).
* **Issue tracking.** Each library repository provides an issue (bug, wish) tracker for users and developers to interact, allowing anonymous view of both open and closed tickets.
Expand Down Expand Up @@ -100,7 +100,8 @@ obtain, provide feedback (as bug reports or enhancements), and contribute to the

* The project's source repository MUST track what changes were made, who made the changes, and when the changes were made.
* To enable collaborative review, the project's source repository SHOULD include interim versions for review between releases; it SHOULD NOT include only final releases.
* The project results MUST have a unique version identifier for each release intended to be used by users. It is recommended to use Semantic Versioning.
* The project results MUST have a unique version identifier for each release intended to be used by users.
We recommend to use either [Semantic Versioning](https://semver.org) or [Calendar Versioning](https://calver.org/) as appropriate, since popular schemes.
* The project MUST provide, in each release, release notes that are a human-readable summary of major changes in that release to help users determine if they should upgrade and what the upgrade impact will be.
The release notes MUST NOT be the raw output of a version control log (e.g., the "git log" command results are not release notes).

Expand Down

0 comments on commit 1f05c7a

Please sign in to comment.