On 30 July 2012 10:16:04 Eric "Sparks" Christensen wrote:
A few weeks ago we received a ticket[0] asking about publishing man
pages for Fedora on the Internet. We know that there are other man
pages out there however we have found that they may not be up to date
with the versions that are in Fedora.
The overall opinion, that I've seen, is that this would be something
that might be worthwhile *if* we can script the entire process.
Does anyone have any ideas for doing this or have any opinions on
doing this?
[0]
https://bugzilla.redhat.com/show_bug.cgi?id=828669
-- Eric
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Fedora Project -
https://fedoraproject.org
Member of:
* Fedora Board
* Documentation Project
097C 82C3 52DF C64A 50C2 E3A3 8076 ABDE 024B B3D1
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Hi:
For the ground-breaking kind of effort this would take, I think it's a waste of
time. We'd be better off spending this effort on improving our pre-existing,
user-oriented documentation. The fact is, only a very small percentage of the
population uses manual pages and there isn't much advantage for them to be
accessible in a web browser.
We need to think about our distribution's target user base. If you're looking
up a manual page, you're using a terminal emulator, and you should be
comfortable enough to know how to use the up-arrow, down-arrow, and 'q'
buttons on your keyboard. In other words, I think the advantage of web-based
manual pages is negligible.
But...
If we do put them online, we should not say "man" anywhere, if possible.
But...
If we can localize the manual pages *and* send the translations upstream, then
maybe it's worth it.
Christopher.