a first set of documentation imported and adapted from spray ones