Не знал в каком п/ф писать, потому не серчайте.

Доброго времени суток.
Начал документировать свою систему, но хотел бы спросить, достаточно ли понятен выбранный мной формат документирования? Я прикреплю файл с документацией одного класса и прошу вас оценить, насколько вы поняли его прочитав документацию. Что в ней лишнее (и почему), а что стоило бы добавить (и почему).
Заранее благодарен
добавлено спустя 2 минуты:
Для ленивых - онлайн читалка http://www.viewdocsonline.com/document/awmzk6

Это как папки в файловой системе, проще найти класс, если он лежит в определенном месте в папке

Я его использую тоже, но в исходниках. Проблемно заставить новичков читать исходники, проще начать с другого формата

Я же показывал рабочий пример:
http://dagparus.ru

Там части экранов еще нету. Работают следующие пункты меню: главная, новости, контакты, Microsoft. Теребили меня запускать сайт, а контент не подготовили. Он кстати веб, так что смотреть через кумп, но люди говорят, что с андройда работает тоже