1

Собственно вопрос (с точки зрения разработчика и написания кода на Swift/Objective C). Существуют ли какие-либо общепринятые стандарты ведения такой документации?

В компаниях, в которых я работал, все ограничивалось кратким описанием проекта (и архитектуры проекта) в произвольном стиле (в виде текстового файла), задачами в таск-менеджере, и комментариями в коде (в начале файла, и в случае неинтуитивности функции - перед функцией).

В то же время, серверный RESTful код документировался с использованием Swagger и его аналогов (на выходе получался мини web-сайт с описаниями всех запросов и параметров).

Приветствуются любые ответы по теме.

2 ответа 2

2

Посмотрите в сторону автоматического документирования кода, например, jazzy: https://github.com/realm/jazzy

1
  • Спасибо, похоже это действительно то, что надо. 19 фев 2019 в 19:01
1

Для документирования используем Confluence.

Из Википедии: вики-система для внутреннего использования организациями с целью создания единой базы знаний.

Плюсы: удобный инструмент с точки зрения доступа, наполнения и поддержания актуальной информации о проекте.

Минусы: необходимость ручного поддержания актуальности информации.

1
  • Дополните свой ответ еще какой нибудь информацией. Например, какие у него плюсы, почему его используют. 19 фев 2019 в 16:40

Ваш ответ

Нажимая на кнопку «Отправить ответ», вы соглашаетесь с нашими пользовательским соглашением, политикой конфиденциальности и политикой о куки

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.