[devel] О документации

[Андрей Черепанов]

3 февраля 2011 Andrew Clark написал:
> 3 февраля 2011 г. 17:23 пользователь Андрей Черепанов <cas на altlinux.ru> 
написал:
> >> Разумеется, предварительно составив список того, что нуждается в
> >> документировании
> >> прежде всего,
> > 
> > Я вижу:
> > 
> > 1. HOWTO по сборке пакета
> 
> Уже есть на вики.
Без объяснения создания спека оно малопригодно.
 
> > 2. Руководство по написание спека
> 
> Уже есть на вики. RPM Guide уже переведен, или есть желание Maximum
> RPM перевести?
Где?
 
> > 3. Руководство по макросам RPM
> 
> По нашим макросам я пытался составить таблицу значений - забросил.
А чего так? Есть драфт?
Полезно было бы давать шаблоны для сборки питоновского модуля, приложения Qt и 
т.п.

> > 4. Best practics по сборке пакетов
> 
> Возможно пригодится.
> 
> > 5. Технологии локальной сборки
> 
> На вики описано. hasher
Слишком сухо и без разъяснений.
 
> > 6. Сборка на git.alt
> 
> Есть там же и много.
Сухие руководства на паре страниц.
 
> > 7. FAQ по ошибкам сборки
> 
> Наиболее частые ошибки?
Да. И заблуждения.

> > 8. Руководство по отладке и решению проблем сборки
> 
> Что-то нетривиальное туда вносить?
Наоборот, избежать велосипедов и отладить ошибки сборки.
 
> > 9. Описание регламентов (policy) по спекам
> 
> Уже есть - насколько актуален - не ясно.
Где?
 
> > 10. Описание регламентов (policy) по организации сборки в Team
> 
> А эти policy есть уже?
А надо принимать.
 
> > 11. Руководство по обновлению пакетов
> > 12. Советы и секреты
> 
> Частично есть на вики.
Я знаю, что есть. проблема в том, что новичок ничего не найдёт.

> > Есть что дополнить/убрать/переформулировать?
> 
> В целом информации на вики достаточно, просто она не структурирована.
> Видимо надо
> разложить ее по местам, что-то объединить, что-то дописать....
> 
> Впрочем, самое главное все равно отсутствует.
Что именно?

-- 
Андрей Черепанов
ALT Linux
cas на altlinux.ru
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 198 байтов
Описание: This is a digitally signed message part.
Url     : <http://lists.altlinux.org/pipermail/devel/attachments/20110203/78989f9f/attachment.bin>