Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
79 changes: 79 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
## Contributing to the Digraphs package for GAP

#### Copyright (C) by Jan De Beule, Julius Jonušas, James D. Mitchell, Wilf A. Wilson, Michael Young et al.
#### Licensing information is available in the LICENSE file.

We invite everyone to contribute by submitting patches, pull requests, and bug
reports. We would like to make the contributing process as easy as possible.

## Issue reporting and code contributions

* Before you report an issue, or wish to add functionality, please try
and check to see if there are existing
[issues](https://github.com/digraphs/Digraphs/issues) or
[pull requests](https://github.com/digraphs/Digraphs/pulls).
We do not want you wasting your time duplicating somebody else's work.
* For substantial changes it is also advisable to contact us before
you start work to discuss your ideas.
* To help increase the chance of your pull request being accepted:
* Run the tests.
* Update the documentation, tests, examples, guides, and whatever
else is affected by your contribution.
* Use appropriate code formatting for both C and GAP (more details below).
* *The Campsite Rule*
A basic rule when contributing to GAP is the **campsite rule**:
leave the codebase in better condition than you found it.
Please clean up any messes that you find, and don't
leave behind new messes for the next contributor.

### Branches for contributions

Bugfixes, technical changes, and new features should be developed in branches
off the `main` branch, in a fork of the repository. You should regularly
merge/rebase the `main` branch into your feature branch.

When you think your changes are ready to go into
a release, please make a pull request.

Before asking us to merge your code please ensure that:

* your code is documented and tested
* all of the tests run without errors
* you have used the coding conventions below

### Coding conventions

* 2 spaces for indentation
* continuation of lines containing `if`, `for`, `while` should be indented by
an extra 2 spaces
* continuation of lines containing an opening bracket but not the matching
closed bracket should be indented so that the content of the next line is
aligned with the opening bracket.
* no tabs
* no trailing whitespace
* no line containing more than one semicolon `;`
* no lines exceeding 80 characters
* the operators `+`, `:=`, `*` and so on, should be immediately preceded and
followed by a space
* there should be no whitespace after an opening bracket or before a closing
bracket
* there should be exactly one space after a comma `,` except if it is at the end
of a line
* there should not be adjacent empty lines
* there should not be variables which are declared but not used
* everything declared in the file `gap/blah.gd` should be documented in the file
`doc/blah.xml`. If a function or method is for internal use only, then its
name should have the prefix `DIGRAPHS_` or one of the suffixes `NC` or `Cons`.
If a function or method is for use in one file only, then it should be
assigned using `BindGlobal` in that file.
* functions should only be assigned using the `foo := function()` syntax if they
are local variables inside another function; all other functions should be global.
* error messages should give enough information for the user to know what they need
to change. For example, if a function has received the wrong input type, an
appropriate error to return is: `ErrorNoReturn("expected [something] as 2nd
argument, found [something else]")`.
* functions and variables which will be unbound after they are read must have
an underscore '_' at the start.

Adapted from the contributing files for
[GAP](https://github.com/gap-system/gap/blob/master/CONTRIBUTING.md)
Loading