## page was renamed from HowToAddDoc
#format wiki
#language ru

= Как поместить документ в Кучу =

Для начала нужно решить вопрос:

'''В каком [:Heap/Formats: формате] выкладывать документ в Кучу?'''

Затем выполнить три действия:

== Предупредить ==

Т. е. получить доступ к incoming Кучи. Для этого нужно написать письмо на адрес joindocs эт altlinux.ru, в котором представиться, 
сообщить свой e-mail и выслать [:Heap/SshKey: публичный ключ для ssh]. В ответ вы получите учётную запись с доступом для размещения документов.

== Создать паспорт документа ==

Чтобы Куча была архивом, а не свалкой, каждый помещаемый в неё документ нужно сопроводить кратким ''паспортом'', необходимым
для корректного хранения и классификации документов. Необходимые данные прикладываются к документу в виде простых текстовых 
файлов:

`docinfo` Заполнение `docinfo` аналогично заполнению какой-нибудь формы (анкеты) в 10 полей и занимает несколько минут. Можно воспользоваться [:-/Titlepage/docinfo.html: шаблоном для изготовления файла docinfo] и [:-/Titlepage/sample.docinfo.html: пояснениями к категориям и полям] или аже [:-/Titlepage/docinfo_gen/docinfo_gen.tar.gz: интерактивной программой на Питоне]. 

`License` Чтобы документ можно было законно распространять, нужно приложить к нему файл `License`, содержащий [:FreeDocs: замечание о правах].

== Упаковать в архив и отправить в incoming Кучи ==

Затем документ вместе с паспортом нужно 
[https://heap.altlinux.ru/adt_policy/s01s03.html#heap.packaging упаковать в архив] и [:IncomingDocs: отправить в Кучу].