documentation initial steps (revision 9)