Исправление
Einstok_Fair,
(текущая версия)
:
Не будем сейчас про мейнтейнера, а про автора моё видение таково:
1) безусловно автор молодец, что написал такой классный продукт, что я в третий раз уже порываюсь его установить, глядя на его описание.
2) аднака, к продукту было бы хорошо сделать документацию для разных групп людей.
3) и в частности для мейнтейнеров в документации было бы чудесно иметь «руководство по сборке».
4) что должно быть в руководстве по сборке?
- описание «платформы», какие используются сторонние библиотеки, откуда их брать, какие версии, для чего они используются, и почему не менее такой-то версии.
- описание структуры репозитория.
почему там те или иные директории, для чего они, для чего нужны те или иные файлы.
- описание сборки программы, какие есть директивы условной компиляции, и что они отключают
- описание деплоймента программы
Как программа должна располагаться в файловой системе, где должны лежать её библиотеки, как устанавливаются аддоны - в какие директории (если они есть), как должна быть установлена документация, чтобы программа ей могла воспользоваться в рантайме (если ей это надо).
- какие-нибудь ещё моменты, которые обычно запрашивают мейнтейнеры (я наверняка не всё сейчас выписал, просто что в голову пришло).
После чего автор сможет просто давать ссылку на эту страницу и он дважды молодец.
Исходная версия
Einstok_Fair,
:
Не будем сейчас про мейнтейнера, а про автора моё видение таково:
1) безусловно автор молодец, что написал такой классный продукт, что я в третий раз уже порываюсь его установить, глядя на его описание.
2) аднака, к продукту было бы хорошо сделать документацию для разных групп людей.
3) и в частности для меёнтейнеров в документации было бы чудесно иметь «руководство по сборке».
4) что должно быть в руководстве по сборке?
- описание «платформы», какие используются сторонние библиотеки, откуда их брать, какие версии, для чего они используются, и почему не менее такой-то версии.
- описание структуры репозитория.
почему там те или иные директории, для чего они, для чего нужны те или иные файлы.
- описание сборки программы, какие есть директивы условной компиляции, и что они отключают
- описание деплоймента программы
Как программа должна располагаться в файловой системе, где должны лежать её библиотеки, как устанавливаются аддоны - в какие директории (если они есть), как должна быть установлена документация, чтобы программа ей могла воспользоваться в рантайме (если ей это надо).
- какие-нибудь ещё моменты, которые обычно запрашивают мейнтейнеры (я наверняка не всё сейчас выписал, просто что в голову пришло).
После чего автор сможет просто давать ссылку на эту страницу и он дважды молодец.