documentation initial steps (revision 2)