ALT Linux Team development discussions
 help / color / mirror / Atom feed
From: "Alexey V. Vissarionov" <gremlin@altlinux.org>
To: ALT Linux Team development discussions <devel@lists.altlinux.org>
Subject: Re: [devel] кому нужна документация в эпоху интернета
Date: Thu, 19 Nov 2020 19:23:42 +0300
Message-ID: <20201119162342.GD32280@altlinux.org> (raw)
In-Reply-To: <20201119161030.GA3442585@portlab>

On 2020-11-19 19:10:30 +0300, Vladimir D. Seleznev wrote:

 >>>> Может быть, я немного утрирую, но лишь совсем немного.
 >>> вопрос в нужности этой документации. т.е. - если бы ей кто-то
 >>> пользовался, то да, конечно надо паковать.
 >>> а если ей никто не пользуется - то зачем ?
 >> Документацию нужно держать в %package doc - когда она нужна, ее
 >> читают не там, где работает основной пакет. А там, где работает
 >> основной пакет, она в 99.9% случаев не нужна.
 > Я от себя ещё добавлю, что разработческую документацию стоит
 > таки держать в %name-devel-doc, а не в %name-devel.

Разумеется. И в %name-doc ей тоже не место: админы и разработчики
в норме читают разную документацию.

Еще, кстати, полезно %name-man в отдельные пакеты выносить, а в
основном пакете писать Requires: %name-man

Просто потому, что есть существенное количество админов, которые
предпочитают держать на боевом ноутбуке полную коллекцию нужной
документации. Даже если описываемое в ней используется где-то еще
(вне боевого ноутбука; возможно, даже на другой архитектуре).


-- 
Alexey V. Vissarionov
gremlin ПРИ altlinux ТЧК org; +vii-cmiii-ccxxix-lxxix-xlii
GPG: 0D92F19E1C0DC36E27F61A29CD17E2B43D879005 @ hkp://keys.gnupg.net


  parent reply	other threads:[~2020-11-19 16:23 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-11-19  9:02 ` [devel] [#262089] EPERM flac.git=1.3.3-alt2 Dmitry V. Levin
2020-11-19 13:23     ` Dmitry V. Levin
2020-11-19 13:34       ` Anton Farygin
2020-11-19 13:46         ` [devel] кому нужна документация в эпоху интернета Dmitry V. Levin
2020-11-19 13:56           ` Alexey Gladkov
2020-11-19 15:56             ` Alexey V. Vissarionov
2020-11-19 16:11               ` Alexey Gladkov
2020-11-19 16:12                 ` Anton Farygin
2020-11-19 16:09             ` [devel] [JT] Re: кому нужны пакеты " Michael Shigorin
2020-11-19 16:17               ` Alexey Gladkov
2020-11-19 15:51           ` [devel] кому нужна документация " Anton Farygin
2020-11-19 15:59             ` Alexey V. Vissarionov
2020-11-19 16:10               ` Vladimir D. Seleznev
2020-11-19 16:11                 ` Anton Farygin
2020-11-19 16:23                 ` Alexey V. Vissarionov [this message]
2020-11-19 16:35                   ` Mikhail Novosyolov
2020-11-20  1:59             ` Leonid Krivoshein
2020-11-20  3:55               ` Alexey V. Vissarionov
2020-11-20 11:16                 ` [devel] про нарубку пакетов (с будкой или по косточке) | " Michael Shigorin
2020-11-20 12:28                   ` Alexey Gladkov
2020-11-20 12:51                   ` Alexey V. Vissarionov
2020-11-20 14:31                     ` [devel] [JT] Re: про нарубку пакетов (с будкой или по косточке) Michael Shigorin
2020-11-19 16:20         ` [devel] [#262089] EPERM flac.git=1.3.3-alt2 Mikhail Novosyolov
2020-11-19 16:32       ` Mikhail Novosyolov

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20201119162342.GD32280@altlinux.org \
    --to=gremlin@altlinux.org \
    --cc=devel@lists.altlinux.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

ALT Linux Team development discussions

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://lore.altlinux.org/devel/0 devel/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 devel devel/ http://lore.altlinux.org/devel \
		devel@altlinux.org devel@altlinux.ru devel@lists.altlinux.org devel@lists.altlinux.ru devel@linux.iplabs.ru mandrake-russian@linuxteam.iplabs.ru sisyphus@linuxteam.iplabs.ru
	public-inbox-index devel

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://lore.altlinux.org/org.altlinux.lists.devel


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git