[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#616457: marked as done (debian-policy: always write version of Debian in documentation at the beginning)

Your message dated Thu, 03 Jan 2013 13:28:12 -0800
with message-id <87mwwqt0r7.fsf@windlord.stanford.edu>
and subject line Re: Bug#616457: debian-policy: always write version of Debian in documentation at the beginning
has caused the Debian Bug report #616457,
regarding debian-policy: always write version of Debian in documentation at the beginning
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
616457: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=616457
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: debian-policy
Severity: normal


Excuse me for my bad English :-)

It is like bad tradition now: many documentation do not contain information about
Debian version. It is very strange for me. How can be authors 100% sure 
that their documentation is absolutely correct for all Debian versions, 
from 1.1 or older to the current?

Examples - documents with no Debian version:
http://www.debian.org/doc/manuals/debian-reference/
http://www.debian.org/doc/manuals/developers-reference/
http://www.debian.org/doc/manuals/debian-faq/ch-basic_defs.en.html
http://www.debian.org/doc/manuals/securing-debian-howto/index.en.html
http://www.debian.org/doc/packaging-manuals/menu.html/
http://www.debian.org/doc/manuals/intro-i18n/

Documents where Debian version is not at the begin:
http://www.debian.org/doc/manuals/maint-guide/ch-start.ru.html
http://www.debian.org/doc/manuals/debian-java-faq/index.html#contents





-- System Information:
Debian Release: 6.0
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.30-2-686 (SMP w/1 CPU core)
Locale: LANG=ru_RU.UTF-8, LC_CTYPE=ru_RU.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

--- End Message ---
--- Begin Message --- 
Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr> writes:
> On Sun, Apr 03, 2011 at 07:59:10PM -0700, Russ Allbery wrote:
>> sergey <sergey_ifeo@rambler.ru> writes:

>> I do appreciate the problem that you're trying to solve here, but I
>> don't think that Policy is the place to do it.

And am now closing this bug on those grounds.

>> If you run across a document that's for end-users, that doesn't contain
>> a note about what Debian releases it applies to, and where you think
>> such a note would be useful, please do file a bug against that package.
>> I think that's an entirely appropriate request.

> Agreed.

>> If the document is on the web and you can't figure out what the
>> corresponding Debian package is, well, that's actually another bug --
>> documents maintained as a Debian package should probably say that
>> somewhere to aid bug filing against the web version.  But you can file
>> the bug against www.debian.org, noting that you can't tell what package
>> it should be filed against, and they can reassign it for you.

>> I'm marking this bug as wontfix but will leave it open in case other
>> folks disagree with my reasoning and would like to argue that Policy
>> should do something here.

> It appears that a "Debian Documentation Policy" (see
> <http://www.debian.org/doc/docpolicy>) exists. I suggest that this
> report be reassigned to this project if at all possible.  CCing
> debian-doc@lists.Debian.org for advice.

There has been no further discussion of this, so I'm going ahead and
closing this bug as rejected against Policy.  If anyone on the
documentation policy side has a queue to which it can be reassigned and
wants to pick it up, please feel free to reopen and reassign.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>

--- End Message ---
Reply to: