On Tue, Jul 31, 2012 at 11:51 AM, Christopher Antila <crantila@xxxxxxxxxxxxxxxxx> wrote:
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
>
> -- EricHi:
>
>
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
> Fedora Project - https://fedoraproject.org
>
> Member of:
> * Fedora Board
> * Documentation Project
>
> 097C 82C3 52DF C64A 50C2 E3A3 8076 ABDE 024B B3D1
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
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.
If we wanted to go forward looking at the packages app, is there a way for us to look its implementation? I see it uses moshka, but the keywords I tossed at http://git.fedorahosted.org/cgit/ didn't find anything.
I like the idea of pushing translated manpages upstream. Does `man` itself have localization features?
--pete
-- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
