Mirror
/
acmed
mirror of https://github.com/breard-r/acmed.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
98 Commits
12 Branches
28 Tags
2.3 MiB
 
 
 
 
Tree: 6d8d1eb529
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '6d8d1eb529'
${ noResults }
acmed/CONTRIBUTING.md

2.9 KiB
Raw Blame History

Contributing to ACMEd

Testing and bug report

The first way to help is to actually use the software and report any bug you encounter. Do not hesitate to test the limits.

Fix issues in dependencies

nix

The nix crate does not currently allow to retrieve an UID or GID from a user or group name, which prevents ACMEd to do so. A pull request has been made to nix in early 2018 but has not been merged yet.

rust-openssl

The openssl does not expose the Asn1Time in a usable way, which requires ACMEd to hack around it by parsing the string representation of such objects. This is sub-optimal and has already caused at least one bug.

Improving the code

As a one-man project, it has several goals already set but not explicitly written in an issue or any other follow-up file. It will not be the case before version 1.0 is released since everything may change at any moment. Therefore, it is recommended to request change instead of implementing them, this way we can discuss how things should be made.

If you really want to submit a pull request, please :

  • document your changes in the man pages and the CHANGELOG.md file
  • write as much tests as you can
  • run cargo test and be sure every test pass
  • format your code using rustfmt
  • be sure not to have any warning when compiling
  • run clippy and fix any issue
  • refrain from including a new dependency (crates having ring in their dependency tree are an absolute no-go)
  • beware of potential repercussions on the default hooks: those should remain usable

Not following the rules above will delay the merge since they will have to be fixed first.

Author vs. contributor

Some people have troubles seeing the difference between an author and a contributor. Here is how it is seen withing this project.

A contributor is a person who helps the project in various ways whenever she or he wants. As such, a contributor does not have any obligation other than being respectful and open-minded. People who wrote code that have been accepted are automatically listed in the contributors page. The creation of a file with the names of people contributing outside of the code base will be studied upon request from such people.

An author is a person who has some responsibilities on the project. Authors are expected to contribute on a regular basis, decide architectural choices, enforce copyright issues and so on. One does not grant himself the author status, it is given by the others authors after having discussed the request.