Altdocs

Материал из ALT Linux Wiki
Stub.png
Данная страница находится в разработке.
Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.


Пакеты документации, создаваемые ALT Docs Team

Тут пока кратко будут излагаться рекомендации/правила/соглашения по пакетам документации.

Пакеты документации, создаваемые ALT Docs Team делятся на

  • модули
  • выпуски

Определение

Модули представляют из себя самодостаточные тексты на определённую тему. Самодостаточность модулей выражается в том, что они не должны содержать ссылок на другие модули.

Выпуски представляют из себя тексты (в минимальном необходимом количестве), обильно содержащие ссылки на модули. Т.е. выпуски служат для объединения модулей.

Именование

Модули как пакеты именуются следующим образом: docs-далее_всё_что_угодно Выпуски именуются следующим образом: docs-issue-далее_всё_что_угодно

Формат

Для наиболее полной интеграции в систему поддерживаются несколько форматов:

  • docbook
  • html
  • m-k