From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.2.3 (2007-08-08) on sa.int.altlinux.org X-Spam-Level: X-Spam-Status: No, score=-2.3 required=5.0 tests=BAYES_00 autolearn=ham version=3.2.3 Message-ID: <47BD4589.2090801@altlinux.ru> Date: Thu, 21 Feb 2008 11:34:01 +0200 From: Michael Bochkaryov User-Agent: Thunderbird 2.0.0.6 (X11/20070804) MIME-Version: 1.0 To: ALT Linux Team development discussions References: <1203365983.15469.3.camel@localhost.localdomain> <20080218213739.GB17859@wo.int.altlinux.org> <20080219074552.GF9730@imap.altlinux.org> <20080219083321.GC1311@wrars-comp.wrarsdomain> <20080219083951.GI9730@imap.altlinux.org> <20080219084313.GE1311@wrars-comp.wrarsdomain> <87ir0lz5x2.fsf@frontier.dottedmag.net> <47BD2D31.5080108@altlinux.ru> <87pruqoie6.fsf@frontier.dottedmag.net> <47BD3550.5040708@altlinux.ru> <87lk5eogvf.fsf@frontier.dottedmag.net> In-Reply-To: <87lk5eogvf.fsf@frontier.dottedmag.net> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Subject: Re: [devel] docs for new maintainers X-BeenThere: devel@lists.altlinux.org X-Mailman-Version: 2.1.9 Precedence: list Reply-To: ALT Linux Team development discussions List-Id: ALT Linux Team development discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 21 Feb 2008 09:31:58 -0000 Archived-At: List-Archive: List-Post: Mikhail Gusarov пишет: > Twas brillig at 10:24:48 21.02.2008 UTC+02 when Michael Bochkaryov did gyre and gimble: > > MB> Может и канонической, но не единственной: > > MB> 1. http://heap.altlinux.org/modules/maintainer_howto.kirill/index.html > MB> 2. http://docs.altlinux.ru/alt/devel/ch02s04.html > MB> 3. локально установленный пакет с документацией > > docs, heap... Что-нибудь придумаем. Неприятно то, что они все не > up-to-date вечно :( Скажем, на docs до сих пор лежит старая версия > "Maintainers' Guide". Ага. Как в той байке про два бранча программы - работающей с багом и неработающей, но без бага ;-) Если есть официальная дока, то она воспринимается с большим приоритетом, чем wiki, архивы рассылок, etc. И получаем граблями по лбу... :) > MB> Как ни странно, но про wiki знают далеко не все, кому это было бы > MB> полезно (проверено на нашем сисадмине). > > /me давно уже пинает вебмастеров, чтобы добавили явную и жирную ссылку > на altlinux.ru. Пока безрезультатно. ...а там следующие грабли лежат... > MB> Кроме того, wiki обычно воспринимается в качестве неформальной и > MB> слабо структурированной базы знаний, какой обычно и является. > > Без главного редактора - да, увы. Если это главный источник актуальной информации, то очень стоит. > Впрочем, надеюсь, после того, как я эту wiki причешу, и она ещё переедет > на адрес http://altlinux.org/, её перестанут воспринимать как таковую. На wiki информация есть, но тут мы получаем граблями второй раз, потому что уже в пределах вики структурированность, актуальность и степень важности информации часто страдают. Могу помочь в виде взгляда со стороны майнтейнера уровня "чайник обыкновенный" :-) -- misha@