documentation initial steps (revision 8)