Документация

Важной частью любой операционной системы является документация, технические руководства, описывающие работу программ и их использование. Стараясь создать свободную операционную систему высокого качества, Проект Debian прикладывает все усилия к тому, чтобы предоставить всем своим пользователям легко доступную документацию.

Быстрый старт

Если вы новичок в Debian, то перед тем, как вы в первый раз установите Debian, мы рекомендуем вам начать с чтения:

При первой установке Debian держите эти документы недалеко, они смогут ответить на множество вопросов, и помогут в работе со свежеустановленной системой Debian. Позже вы, возможно, захотите ознакомиться с:

В заключение, распечатайте и держите недалеко Справочник-карту по Debian GNU/Linux, список большинства важных команд для системы Debian.

Если вы хотите начать разрабатывать пакеты для Debian, мы рекомендуем вам ознакомиться с:

Ниже перечислена дополнительная документация.

Типы документации

Большинство документации, включённой в Debian, была написана для GNU/Linux в целом. Существует также некоторая документация, написанная специально для Debian. Эти документы идут в следующих основных категориях:

Руководства

Руководства подобны книгам, потому что они исчерпывающе описывают главные темы.

Руководства, созданные специально для Debian

Полный список руководств Debian и другой документации вы можете найти на web-страницах Проекта документации Debian.

Кроме того, несколько предназначенных для пользователей руководств по Debian GNU/Linux, изданы в виде печатных книг.

Руководства по GNU/Linux в целом

Вот некоторые из наиболее популярных документов и руководств по Linux: Linux Installation and Getting Started (Установка Linux и начало работы), Linux Users' Guide (Руководство пользователя Linux), Network Administrators' Guide (Руководство сетевого администратора), System Administrator's Guide (Руководство системного администратора), и другие.

Документация Linux координируется усилиями Проекта документации Linux (LDP, Linux Documentation Project). Вы можете найти полный набор руководств LDP на их web-страницах, среди большого количества другой документации, как в электронном, так и в печатном виде.

HOWTO

Документы HOWTO, как следует из их названия (от английского "how to (do something)" - "как (сделать что-либо)"), описывают как сделать что-то, и они обычно объясняют какие-то конкретные вопросы.

Некоторые из наиболее важных HOWTO по Linux:

Они также доступны для установки на вашу систему в виде пакетов doc-linux-text и doc-linux-html.

FAQ

FAQ означает frequently asked questions (часто задаваемые вопросы). FAQ это документ, который отвечает на эти вопросы.

FAQ по Linux содержит информацию по Linux в целом.

Ответы на вопросы, относящиеся конкретно к Debian, можно найти в FAQ по Debian. Существует также отдельный документ FAQ по образам CD и DVD Debian..

Более подробную информацию вы можете найти в Указателе FAQ LDP.

Другие, более короткие документы

Следующие документы содержат кратние быстрые инструкции:

страницы руководств (manual pages)
Все программы в Unix традиционно документируются с помощью страниц руководств, доступ к справочным руководствам сделан через команду man. Обычно они не предназначены для новичков. Вы можете искать и читать страницы руководств, которые есть в Debian, на http://manpages.debian.net/.
файлы информации (info files)
Множество программ GNU вместо страниц руководств документируется с помощью файлов информации. Эти файлы содержат подробную информацию о самой программе, опциях и примерах использования, и доступны через команду info.
разные файлы README
Файлы read me (прочти меня) также часто встречаются — это просто текстовые файлы, которые описывают единственную тему, обычно пакет. Вы можете найти множество их в поддиректориях вашей системы Debian /usr/share/doc/. В этой директории каждый пакет программного обеспечения имеет поддиректорию с его собственными файлами read me, и, кроме того, может содержать примеры конфигураций. Однако, для больших программ, документация обычно предоставляется в отдельном пакете с таким же именем, как и оригинальный пакет, но заканчивающемся на -doc).
Краткие справочники-карты

Краткие справочники-карты — очень короткие изложения некоторых (под)систем. Обычно такие справочники описывают наиболее часто используемые команды на одном листе бумаги. Некоторые справочники могут быть найдены на:

Справочник-карта по Debian GNU/Linux
Эта карта может быть распечатана на одной странице, предоставляет собой список большинства важных команд и является хорошим справочником для новых пользователей Debian, которые хотят ознакомиться с ним ближе. В основном для неё необходимы базовые знания о компьютере, файлах, директориях и командной строке. Новые пользователи могут начать с чтения Справочника Debian.
refcards.com
Коллекция справочников, сфокусированных, главным образом, на Свободном и Открытом ПО
Краткие справочники-карты
Коллекция справочников о наиболее популярных программах и языках программирования

Если вы прочитали все перечисленные ресурсы, но так и не нашли ответов на свои вопросы или решений к вашим проблемам, относящимся к Debian, взгляните на нашу страницу поддержки.