Как написать документацию для приложения?

Спасибо за разьяснение.
Но хотелось бы немного поподробнее, какие типы документаций бывают(документация к коду, для отдельных функций? или это одно и тоже), идеальный пример на гитхабе для практики...
Поискал в инете, так и не нашел какую нибудь волшебную ссылку.

DEATH2298, а и нет никакой волшебной ссылки. А писал разьяснения по собственному опыту и сверял с источниками в интернете, чтобы убедиться, что моя интерпретация соответствует общепринятой. А так каждое понятие в отдельности разяснено в интернете, можно искать типа "use cases vs user stories". Можно искать "functional specification example document". Вы может быть удивитесь, но найти какие нибудь опенсорсные проекты которые прописывают себе спецификацию практически невозможно. Писать спецификацию, это очень дорого, и долго, для этого нужны специальные люди. И юзер сторис, даже если их "продают" в аджайле как легковесную замену фунциональной спецификации, не являются заменой, и хорошо их писать тоже, блин, надо уметь.
В аджайле просто обычно не пишут фунциональную спецификацию, а делают наброски, где затруднения и вопросы решают по мере их поступления в диалоге с заказчиком. И быстрее это или дешевле или гибче, это, конечно, трудно сказать. Но по опыту, никакая фунциональная спецификация не исключит в конце концов вопросов и неясностей. Так что что ты пишешь ее что нет. Так лучше наверно решать по ходу дела. Потому что в этом документе как таковом нет никакой ценности по окончании проекта, потом это мертвый артефакт.
С другой стороны в геймдизайне до сих пор используется диздок, это функциональная спецификация игры, и она очень подробна. Стоимость разработки игр очень большая, и спецификацию "заставляют" писать для того чтобы уже на этапе концепции отсеивать возможные будущие проблемы.