DOC: 2.clazz_declaration.md - improvements