Edit on GitHub!

Styleguides

Table Of Contents

English language convention

The convention for all the project’s documents, including code documentation, website, is to write American English. A list of spelling differences between British and American English is available here for example.

Contributing to the CoMPAS project also requires using correct copyright headers in source files.

For each CoMPAS repository, we created / will create a Github Action featuring REUSE. REUSE is a piece of software which checks for correct copyright information in files defined in a specification. The specification is based on best practices and the use of SPDX identifiers.

Example Alliander copyright header for Java files:

// SPDX-FileCopyrightText: 2020 Alliander N.V.
//
// SPDX-License-Identifier: Apache-2.0

Every commit on a Pull Request is being scanned by REUSE. If it fails, the pull requests cannot be merged.

For more tips on using REUSE (for example with a small command line tool), check the Tips: Copyright & Licensing wiki page.

Java StyleGuide

As a simple yet instructive example, consider …

/**
 * Example?
 */

Git Commit Messages

As usual, please start the commit message with a short line describing the commit, then leave a blank line, then give more context and explanations. You can use GitHub’s integrations, for example to link to existing issues. In general, pull requests with more than one commits will be squashed when merged in master.