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. -- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
