[Comm] git.alt/gear docs (was: [JT] Re: I: chromium-browser)

[Comm] git.alt/gear docs (was: [JT] Re: I: chromium-browser)

[Michael Shigorin]

On Mon, Nov 16, 2009 at 05:33:12PM +0300, Андрей Черепанов wrote:
> altlinux.org/Git
> altlinux.org/Gear
> чем не удовлетворяет? Какие вопросы не освещены?

Например, отсутствием описания хотя бы одного workflow,
хотя бы отдалённо близкого для сторонних разработчиков
по удобству к "src.rpm с аккуратно разложенными патчами".

Ковыряться в свалке коммитов в одном master -- это ужас.
Как и мегапатч в "техническом" src.rpm.

> Без нормальной конструктивной обратной связи так и останется
> то, что есть.

В данном случае не было освещено вот это:
http://www.altlinux.org/?title=Git.alt%2FСправочник&diff=12713&oldid=12505

(btw кроме /people что ещё практически полезно -- /gears?
хорошо бы там уточнить мою формулировку)

PS: я мог что-то пропустить, разумеется.  Но пока имею разве что
стопку отобранных тематических писем в devel@ и sisyphus@,
отчасти неразобранную.

PPS: и тема эта для devel@, опять же.

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [Comm] git.alt/gear docs (was: [JT] Re: I: chromium-browser)

[Andriy Dobrovol`s`kii]

2009/11/16 Michael Shigorin <mike@osdn.org.ua>:
> PPS: и тема эта для devel@, опять же.
>
Не, Миш, тема именно для здесь. Чтоб в девеле это уже не обсуждать.
Там это уже малопродуктивная трата времени на "общефизическую"
подготовку.
Ну на крайний случай, в девеле для новичков.
-- 
Regards,
Andrii Dobrovol`s`kyj

Re: [Comm] git.alt/gear docs

[Motsyo Gennadi aka Drool]

16.11.2009 18:20, Andriy Dobrovol`s`kii пишет:
> Не, Миш, тема именно для здесь. Чтоб в девеле это уже не обсуждать.
> Там это уже малопродуктивная трата времени на "общефизическую"
> подготовку.

	В devel@ гуры обкидают меня тапками с пошлют в %_docdir/%_mandir.
	Нужна "живая" документация - "на пальцах", для живых людей, с примерами
из жизни, что-то вроде "один день из жизни простого мантейнера". То, что
имеется сейчас - только запутывает.
	"Живая" документация даст, пусть не большой, но толчок к привлечению
новых мантейнеров. Я лично знаю нескольких людей, которые вполне
нормально пакуют, но после моих ссылок на нашу вики про git/gear
выразились не очень лестно и продолжают паковать "для себя", иногда
выбрасывая свой пакет куда-нить для попросивших.

Re: [Comm] git.alt/gear docs

[Dmitriy Kruglikov]

16 ноября 2009 г. 19:08 пользователь Motsyo Gennadi aka Drool  написал:
>  Нужна "живая" документация - "на пальцах", для живых людей, с примерами
> из жизни, что-то вроде "один день из жизни простого мантейнера".

А вот я идейку подкину, для размышления ...
Про живую документацию, с поиском, закладками и всякими другими вкусностями ...

Есть такой звёр, называется Qt Assistant ...
Ему можно скармливать, подготовленые специальным образом, сборники
с чем угодно ...
Кому интересно, посмотрите в нем же раздел:
Using Qt Assistant as a Custom Help Viewer

Можно написать интерфейс для удобного редактирования файлов коллекций,
а дальше, с миру по нитке ...

Как вам такая идейка?

P.S.
Для начала можно ссылки на внешние источники информации собрать в коллекцию ...
Потом уже и локально ...


-- 
Best regards,
 Dmitriy Kruglikov
 Dmitriy.Kruglikov_at_gmail_dot_com
 XMPP: Dmitriy.Kruglikov_at_gmail_dot_com

Re: [Comm] git.alt/gear docs

[Michael Shigorin]

On Mon, Nov 16, 2009 at 07:19:22PM +0200, Dmitriy Kruglikov wrote:
> А вот я идейку подкину, для размышления ...
> Про живую документацию, с поиском, закладками и всякими другими вкусностями ...

IMHO лучше сразу http://www.altlinux.org, чтоб не возиться потом
всё равно с переносом.

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [Comm] git.alt/gear docs

[Dmitriy Kruglikov]

16 ноября 2009 г. 19:24 пользователь Michael Shigorin  написал:

> IMHO лучше сразу http://www.altlinux.org, чтоб не возиться потом
> всё равно с переносом.
Оно-то да, кроме случаев, когда документация нужна, а Инета нет ...
Ну и персональные закладки лучше "тут", чем "там" ...

На мой личный взгляд, естественно :)

P.S.
А отдельная коллекция "по мотивам" altlinux.org всяко будет полезной ...


-- 
Best regards,
 Dmitriy Kruglikov
 Dmitriy.Kruglikov_at_gmail_dot_com
 XMPP: Dmitriy.Kruglikov_at_gmail_dot_com