Skip to content
Snippets Groups Projects
Stefan Hynek's avatar
Stefan Hynek authored
# [1.2.0](v1.1.1...v1.2.0) (2020-09-24)

### Features

* add terminology, minor styling and language updates ([7eff3315](7eff3315))
c0ac18fe
History

RDD Technical Reference

Guidelines and references for software development in RDD.

To create main markdown document, run

cat technical-reference-main.txt | while read LINE; do cat $LINE >> technical-reference.md ; done

To compile the markdown file into a PDF document, run

pandoc --template=rdd.latex technical-reference.md -o technical-reference.pdf  --shift-heading-level-by=-1

or, for the use with docker,

docker run --rm -v $(pwd):/data pandoc/latex:2.9.1.1 pandoc technical-reference.md -o technical-reference.pdf --template=rdd.latex --shift-heading-level-by=-1

For convenience, a build script is provided with this repo.

Inspired by the EURISE Network Technical Reference.

Sources and PDF

The sources and the PDF of this reference are available continuously with every release here: https://gitlab.gwdg.de/fe/technical-reference/-/releases

Contributing

Commits have to be made following a certain convention that is defined by the Conventional Commit standard. This repo is configured to be used with Commitizen for your convenience and uses the angular preset.

Install it with

npm install

You can now run a commit using commitizen with git cz.

To run commitizen on git commit rather than on git cz, update or create .git/hooks/prepare-commit-msg with the following code:

#!/bin/bash
exec < /dev/tty && node_modules/.bin/git-cz --hook || true

We have chosen the following two types of commits to be used for the work on the technical reference that should reflect the extent of your contribution:

  • fix: Small addition to or revision of the Technical Reference's Markdown files.
  • feat: Medium addition to or revision of the Technical Reference's Markdown files.

These commit types trigger a patch or minor release when merged into the master branch. To trigger a major release, please consult your fellow contributors and mark one of your commits with a BREAKING CHANGE.

The master branch is protected for direct commits, so please use feature branches and do merge them into master.