add bits and pieces of documentation

3 files changed