Contributing

Conventions

• Folders for recipes are named chapter-N/recipe-M, where N is the chapter number and M is a number, i.e. 01, 02, etc. In each chapter we restart the recipe counter.
• Each recipe can have more than one example subfolder. These subfolders are named *example*. Any code must reside in these subfolders.

Updating the table of contents and generate README files

The README files that form the table of contents (main README.md, chapter READMEs and recipe READMEs are generated from title.txt and abstract.md files.

This means that you should not modify README.md files but rather only edit title.txt and abstract.md files.

To update the README files, run python contributing/generate-readmes.py - this file updates READMEs in place.

Coding style

Indentation

We use 2 spaces instead of 4 spaces to reduce the printed page width. No tabs.

Case of commands

We use lowercase for commands, i.e.:

cmake_minimum_required(VERSION 3.5 FATAL_ERROR)

and not:

CMAKE_MINIMUM_REQUIRED(VERSION 3.5 FATAL_ERROR)

Line continuation

It is OK to put commands on one line if it improves readability, e.g.:

list(APPEND CXX_BASIC_FLAGS "-g3" "-O1")

For line continuation we use the following style:

target_compile_options(asan-example
  PUBLIC
    ${CXX_BASIC_FLAGS}
    ${_asan_flags}
  )

set(_whathaveyou
  item1
  item2
  item3
  )

Variable names

Start an internal variable (i.e. one that is not exposed to the user) with an underscore:

set(PUBLIC_VARIABLE "this one is exposed")

set(_temp "this one is internal")