Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.debian.user > #174995
| From | Darac Marjal <mailinglist@darac.org.uk> |
|---|---|
| Newsgroups | linux.debian.user |
| Subject | Re: Why? -- "A Modest Proposal" |
| Date | 2016-11-22 13:00 +0100 |
| Message-ID | <sGhTX-6Ds-1@gated-at.bofh.it> (permalink) |
| References | <sE9e9-42d-11@gated-at.bofh.it> <sGcrg-3oO-7@gated-at.bofh.it> |
| Organization | linux.* mail to news gateway |
On Tue, Nov 22, 2016 at 01:00:49AM -0500, kamaraju kusumanchi wrote: >On Wed, Nov 16, 2016 at 9:13 AM, Richard Owlett <rowlett@cloud85.net> wrote: >> There exist SOC <Summer of Code> projects to encourage/mentor fledgling >> programmers. >> Considering the state of documentation, esp man pages, why no SOD <Summer of >> Documentation> projects for potential tech writers. >> >> In many areas, nerds are considered illiterate. I can see SOD projects as a >> vehicle to encourage technically oriented teens to hone their composition >> skills. Attempting to edit existing man pages might be a good starting >> point. It would obviously require mentors with an atypical mixture of skill >> sets. >> > >One side note. IMHO man pages/info pages have a huge barrier of entry. >You have to learn a new language to write one and that can be Not necessarily. There are tools which convert from one document format to man pages. pod2man creates man pages from perl's embedded POD format. For Python there's sphinx or doxygen. For more generic purposes, DocBook renders to all sorts of outputs. Not creating documentation CONTENT because of PRESENTATION issues is specious, really. >discouraging to some. Ideally, a documentation developer would just >focus on the content and does not spend much time on the meta aspects >of documentation (ex:- typesetting/formatting etc.,). From this >aspect, a wiki is an ideal way to document something... but may be >there are better tools out there that I am unaware of. > >thanks >raju >-- >Kamaraju S Kusumanchi | http://raju.shoutwiki.com/wiki/Blog > -- For more information, please reread.
Back to linux.debian.user | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-16 15:20 +0100
Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-16 16:00 +0100
Re: Why? -- "A Modest Proposal" Jonathan Dowland <jmtd@debian.org> - 2016-11-16 16:20 +0100
Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-16 19:40 +0100
Re: Why? -- "A Modest Proposal" Jonathan Dowland <jmtd@debian.org> - 2016-11-17 13:20 +0100
Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-17 15:30 +0100
Re: Why? -- "A Modest Proposal" Jonathan Dowland <jmtd@debian.org> - 2016-11-17 15:50 +0100
Re: Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-17 15:50 +0100
Re: Why? -- "A Modest Proposal" Lisi Reisz <lisi.reisz@gmail.com> - 2016-11-17 17:40 +0100
Re: Why? -- "A Modest Proposal" Curt <curty@free.fr> - 2016-11-17 18:10 +0100
Re: Why? -- "A Modest Proposal" kamaraju kusumanchi <raju.mailinglists@gmail.com> - 2016-11-22 06:40 +0100
Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-16 16:40 +0100
Re: Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-17 16:00 +0100
Re: Why? -- "A Modest Proposal" "John L. Ries" <jries@salford-systems.com> - 2016-11-17 19:00 +0100
Re: Why? -- "A Modest Proposal" Greg Wooledge <wooledg@eeg.ccf.org> - 2016-11-17 22:40 +0100
Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-17 22:40 +0100
Re: Why? -- "A Modest Proposal" rhkramer@gmail.com - 2016-11-18 00:10 +0100
Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-17 22:30 +0100
Re: Why? -- "A Modest Proposal" Greg Wooledge <wooledg@eeg.ccf.org> - 2016-11-17 22:40 +0100
Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-17 22:40 +0100
Re: Why? -- "A Modest Proposal" Greg Wooledge <wooledg@eeg.ccf.org> - 2016-11-17 23:00 +0100
Re: Why? -- "A Modest Proposal" Reco <recoverym4n@gmail.com> - 2016-11-18 09:20 +0100
Re: Why? -- "A Modest Proposal" rhkramer@gmail.com - 2016-11-18 00:10 +0100
Re: Why? -- "A Modest Proposal" emetib <chadbrabec@gmail.com> - 2016-11-18 09:50 +0100
Re: Why? -- "A Modest Proposal" <tomas@tuxteam.de> - 2016-11-18 10:40 +0100
Re: Why? -- "A Modest Proposal" "Thomas Schmitt" <scdbackup@gmx.net> - 2016-11-18 11:10 +0100
Re: Why? -- "A Modest Proposal" emetib <chadbrabec@gmail.com> - 2016-11-18 20:30 +0100
Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") cbannister@slingshot.co.nz - 2016-12-29 15:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-29 19:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-29 19:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-29 19:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-30 02:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 03:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 03:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Greg Wooledge <wooledg@eeg.ccf.org> - 2016-12-30 15:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Dan Purgert <dan@djph.net> - 2016-12-30 18:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Dan Purgert <dan@djph.net> - 2016-12-30 15:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 15:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 15:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 16:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") John Hasler <jhasler@newsguy.com> - 2016-12-30 17:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 08:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 09:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 10:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-31 17:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 14:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Nemeth Gyorgy <friczy@freemail.hu> - 2016-12-31 10:40 +0100
Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2016-12-31 12:00 +0100
Re: Do have programs have poor documentation? Xen <list@xenhideout.nl> - 2017-01-01 12:40 +0100
Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2017-01-01 14:10 +0100
Re: Do have programs have poor documentation? Xen <list@xenhideout.nl> - 2017-01-01 19:10 +0100
Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2017-01-01 20:50 +0100
Re: Do have programs have poor documentation? Gene Heskett <gheskett@shentel.net> - 2017-01-01 15:10 +0100
Re: Do have programs have poor documentation? "Thomas Schmitt" <scdbackup@gmx.net> - 2017-01-01 20:50 +0100
Re: Do have programs have poor documentation? Gene Heskett <gheskett@shentel.net> - 2017-01-02 02:10 +0100
Re: Do have programs have poor documentation? Lisi Reisz <lisi.reisz@gmail.com> - 2017-01-02 02:30 +0100
Re: Do have programs have poor documentation? David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 16:00 +0100
Re: Do have programs have poor documentation? rhkramer@gmail.com - 2017-01-02 17:30 +0100
Re: Do have programs have poor documentation? David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 18:20 +0100
Re: Do have programs have poor documentation? rhkramer@gmail.com - 2017-01-02 18:50 +0100
Re: Do have programs have poor documentation? Eike Lantzsch <zp6cge@gmx.net> - 2017-01-01 18:00 +0100
Re: Do have programs have poor documentation? Xen <list@xenhideout.nl> - 2017-01-01 19:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-31 15:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 12:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 15:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2017-01-02 17:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") David Wright <deblis@lionunicorn.co.uk> - 2017-01-02 18:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2017-01-02 18:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Jörg-Volker Peetz <jvpeetz@web.de> - 2017-01-02 19:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-30 02:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 03:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2016-12-30 18:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Dan Purgert <dan@djph.net> - 2017-01-01 12:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 12:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 14:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 15:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 16:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 17:20 +0100
[OT] on education [was]: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 20:40 +0100
Re: [OT] on education [was]: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Nicolas George <george@nsup.org> - 2017-01-01 23:50 +0100
Re: [OT] on education [was]: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Joel Rees <joel.rees@gmail.com> - 2017-01-02 01:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Rob van der Putten <rob@sput.nl> - 2017-03-12 17:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 08:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 10:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2017-01-01 13:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 13:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-01-01 14:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2017-01-01 18:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <xen@dds.nl> - 2017-01-01 20:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Bob Holtzman <holtzm@cox.net> - 2017-01-02 20:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") cbannister@slingshot.co.nz - 2017-03-11 10:00 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Martin Read <zen75502@zen.co.uk> - 2017-03-11 12:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2017-03-11 14:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Doug <dmcgarrett@optonline.net> - 2017-03-11 19:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Dan Purgert <dan@djph.net> - 2017-03-13 13:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Catherine Gramze <rhiamom@gmail.com> - 2016-12-30 04:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Xen <list@xenhideout.nl> - 2016-12-31 08:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-30 12:40 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Richard Owlett <rowlett@cloud85.net> - 2016-12-30 13:30 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Dan Purgert <dan@djph.net> - 2016-12-30 15:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") rhkramer@gmail.com - 2016-12-30 15:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2016-12-30 20:50 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 00:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") deloptes <deloptes@gmail.com> - 2016-12-31 01:10 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Lisi Reisz <lisi.reisz@gmail.com> - 2016-12-31 01:50 +0100
[OT] Antikythera mechanism [was Re: Do have programs have poor documentation?] Miles Fidelman <mfidelman@meetinghouse.net> - 2016-12-31 03:20 +0100
Re: [OT] Antikythera mechanism [was Re: Do have programs have poor documentation?] deloptes <deloptes@gmail.com> - 2016-12-31 10:20 +0100
Re: Do have programs have poor documentation? (was ... Re: Why? -- "A Modest Proposal") Rob van der Putten <rob@sput.nl> - 2017-03-11 22:50 +0100
Re: Why? -- "A Modest Proposal" kamaraju kusumanchi <raju.mailinglists@gmail.com> - 2016-11-22 07:10 +0100
Re: Why? -- "A Modest Proposal" Darac Marjal <mailinglist@darac.org.uk> - 2016-11-22 13:00 +0100
Re: Why? -- "A Modest Proposal" Richard Owlett <rowlett@cloud85.net> - 2016-11-22 13:30 +0100
csiph-web