documentation initial steps (revision 1)