From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <kirill@altlinux.org>
Date: Fri, 8 Jun 2007 15:35:07 +0400
From: Kirill Maslinsky <kirill@altlinux.org>
To: devel@lists.altlinux.org
Message-ID: <20070608113507.GD26934@master.altlinux.org>
Mail-Followup-To: devel@lists.altlinux.org
References: <20070607182107.GA6234@hint1.office.altlinux.org>
	<75e139a00706080040meaff1bft3ce8a1f68285b616@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=koi8-r
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <75e139a00706080040meaff1bft3ce8a1f68285b616@mail.gmail.com>
User-Agent: Mutt/1.4.2.1i
Organization: ALT Docs Team
Subject: Re: [devel] on names and descriptions of docs- packages
X-BeenThere: devel@lists.altlinux.org
X-Mailman-Version: 2.1.9rc1
Precedence: list
Reply-To: ALT Devel discussion list <devel@lists.altlinux.org>
List-Id: ALT Devel discussion list <devel.lists.altlinux.org>
List-Unsubscribe: <https://lists.altlinux.org/mailman/listinfo/devel>,
	<mailto:devel-request@lists.altlinux.org?subject=unsubscribe>
List-Archive: <http://lists.altlinux.org/pipermail/devel>
List-Post: <mailto:devel@lists.altlinux.org>
List-Help: <mailto:devel-request@lists.altlinux.org?subject=help>
List-Subscribe: <https://lists.altlinux.org/mailman/listinfo/devel>,
	<mailto:devel-request@lists.altlinux.org?subject=subscribe>
X-List-Received-Date: Fri, 08 Jun 2007 11:35:08 -0000
Archived-At: <http://lore.altlinux.org/devel/20070608113507.GD26934@master.altlinux.org/>
List-Archive: <http://lore.altlinux.org/devel/>
List-Post: <mailto:devel@altlinux.org>

On Fri, Jun 08, 2007 at 02:40:45PM +0700, Slava Semushin wrote:
> 2007/6/8, QA Team Robot <qa / altlinux.org>:
> >         5 ADDED packages
> >
> > docs-manual_config-azol - manual_config
> > * Wed Jun 06 2007 Artem Zolochevskiy <azol@altlinux> 0.1-alt1
> > - initial build for Sisyphus
> >
> > docs-quickstart-azol - Quickstart
> > * Wed Jun 06 2007 Artem Zolochevskiy <azol@altlinux> 4.0-alt1
> > - intial build for Sisyphus
> [...]
> 
> Я в очередной раз рескую показаться чересчур придирчивым, но у этих
> двух пакетов абсолютно невнятные Summary. Что занчит manual_config?
> Это конфиг для рук? И что за quickstart? Быстрый старт чего? :) Мне
> вот абсолютно неясно о чем там вообще речь.

Поддерживаю, summary надо уточнить. Это существенно для пользователя, 
поскольку по summary ищет apt-cache search -- поэтому необходимо,
чтобы в описании присутствовали ключевые слова, релевантные содержанию
документа. По этой же причине для пакетов с документацией на русском
языке очень важно иметь summary и description на русском.

Замечания по именам этих двух пакетов мне тоже кажутся уместными,
хотя переименование пакетов -- достаточно непрямая операция, так что
лучше тут оставить как есть -- это менее принципиально. Можно будет
исправить по случаю, например, возникновения name clash, скажем,
при появлении пакета с quickstart чего-нибудь другого.

PS Хочу напомнить о существовании рассылки docs@, где подобное
обсуждение было бы даже более уместно.

-- 
Kirill Maslinsky
ALT Docs Team
http://heap.altlinux.ru