[FM Discuss] Tech-comm student volunteers
davidm at austincc.edu
davidm at austincc.edu
Thu Apr 9 08:02:27 PDT 2009
Hello. I'm David McMurrey -- I teach several courses in which students do a
final project. They look for some small shareware or freeware application and,
ideally, work with the developer to do some sort of user guide, helps, etc.
The courses:
http://www.io.com/~tcm/etwr2374/sched_online.html (features Robo)
http://www.io.com/~tcm/etwr2379/sched_online.html (technical editing)
http://www.io.com/~tcm/etwr2472/sched_online.html (features FrameMaker)
Is there any way that my students could volunteer for some small writing or
editing project in FLOSS manuals?
-- David McMurrey
www.io.com/~hcexres
discuss-request at lists.flossmanuals.net said:
> Send Discuss mailing list submissions to
> discuss at lists.flossmanuals.net
>
> To subscribe or unsubscribe via the World Wide Web, visit
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> or, via email, send a message with subject or body 'help' to
> discuss-request at lists.flossmanuals.net
>
> You can reach the person managing the list at
> discuss-owner at lists.flossmanuals.net
>
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of Discuss digest..."
>
>
> Today's Topics:
>
> 1. Re: pre tag for strong now fixed font width (Jay Maechtlen)
> 2. Re: pre tag for strong now fixed font width (adam hyde)
> 3. command line manual - please have a squiz (adam hyde)
> 4. dates (adam hyde)
> 5. Re: dates (Janet Swisher)
> 6. Re: dates (adam hyde)
> 7. Re: command line manual - please have a squiz (Andy Oram)
> 8. Re: command line manual - please have a squiz (Luka Frelih)
> 9. Re: command line manual - please have a squiz (adam hyde)
>
>
> ----------------------------------------------------------------------
>
> Message: 1
> Date: Thu, 09 Apr 2009 00:39:37 -0700
> From: Jay Maechtlen <techwriter at covad.net>
> Subject: Re: [FM Discuss] pre tag for strong now fixed font width
> To: discuss at lists.flossmanuals.net
> Message-ID: <49DDA639.4010700 at covad.net>
> Content-Type: text/plain; charset=ISO-8859-1; format=flowed
>
>
>
> Douglas Bagnall wrote:
> > Ed wrote:
> >
> >
> >
> > I agree with your point, but the proper html would be <code></code>.
> >
> > If all the bold bits in the command line manual really are code
> > examples, we could fix that on the server.
> >
> > Douglas
> >
>
> I think the point is:
> Bold needs to be available for the usual purposes.
> Italic, likewise.
>
> There should be a way to designate code samples in the document source
> such that they will be typographically decent in the output, without
> making other codes unusable for the normal text purposes.
> Regards
> Jay
>
> --
> Jay Maechtlen
> 626 444-5112 office
> 626 840-8875 cell
> www.laserpubs.com
>
>
>
> ------------------------------
>
> Message: 2
> Date: Thu, 09 Apr 2009 10:52:32 +0200
> From: adam hyde <adam at flossmanuals.net>
> Subject: Re: [FM Discuss] pre tag for strong now fixed font width
> To: discuss at lists.flossmanuals.net
> Message-ID: <1239267152.12423.39.camel at esetera>
> Content-Type: text/plain
>
> huh? no, its just the pre tag strong that is effected
>
> adam
>
> On Wed, 2009-04-08 at 16:21 -0700, Edward Cherlin wrote:
> > On Wed, Apr 8, 2009 at 2:23 PM, adam hyde <adam at flossmanuals.net> wrote:
> > > hi,
> > >
> > > I changed the objavi css so that b and strong tags now are rendered in
> > > the book-formatted PDF as courier (fixed-width font)
> >
> > I'm sorry to hear that. I like to be able to use bold serif fonts once
> > in a while. I suppose that this means we should go back through all of
> > the books and check all of the <b> and <strong> tags.
> >
> > Why not have a button to insert <font face="Courier">text</font>, the
> > way HTML is defined?
> >
> > > adam
> > >
> > >
> > > --
> > > Adam Hyde
> > > Founder FLOSS Manuals
> > > German mobile : + 49 15 2230 54563
> > > Email : adam at flossmanuals.net
> > > irc: irc.freenode.net #flossmanuals
> > >
> > > "Free manuals for free software"
> > > http://www.flossmanuals.net/about
> > >
> > >
> > > _______________________________________________
> > > Discuss mailing list
> > > Discuss at lists.flossmanuals.net
> > > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> > >
> >
> >
> >
> --
> Adam Hyde
> Founder FLOSS Manuals
> German mobile : + 49 15 2230 54563
> Email : adam at flossmanuals.net
> irc: irc.freenode.net #flossmanuals
>
> "Free manuals for free software"
> http://www.flossmanuals.net/about
>
>
>
>
> ------------------------------
>
> Message: 3
> Date: Thu, 09 Apr 2009 12:42:00 +0200
> From: adam hyde <adam at flossmanuals.net>
> Subject: [FM Discuss] command line manual - please have a squiz
> To: floss <discuss at lists.flossmanuals.net>
> Message-ID: <1239273720.12423.71.camel at esetera>
> Content-Type: text/plain
>
> soooo....the rather amazing command line manual is pretty much good to
> go...we will send to the FSF and they will print 200 and give us the $
> which in turn goes towards another collab sprint with the FSF...
>
> there has been some amazing contribs to this manual and no little thanks
> to andy for being the master maintainer for the manual...it looks and
> reads fantastico!
>
> there is a copy of the pdf here:
> http://adam.engagetv.com/cli/
>
> this will go to the printer. there might be a few tweaks, but this is
> pretty much it
>
> last call for feedback...
>
> adam
>
>
>
>
> --
> Adam Hyde
> Founder FLOSS Manuals
> German mobile : + 49 15 2230 54563
> Email : adam at flossmanuals.net
> irc: irc.freenode.net #flossmanuals
>
> "Free manuals for free software"
> http://www.flossmanuals.net/about
>
>
>
>
> ------------------------------
>
> Message: 4
> Date: Thu, 09 Apr 2009 13:19:44 +0200
> From: adam hyde <adam at flossmanuals.net>
> Subject: [FM Discuss] dates
> To: floss <discuss at lists.flossmanuals.net>
> Message-ID: <1239275984.12423.104.camel at esetera>
> Content-Type: text/plain
>
> heyhey,
>
> some dates :
>
> April 27-30
> Possibly FireFox Book Sprint to continue the good work done at DocTrain
> a few weeks ago, I am trying to get this confirmed at the moment
> With the Mozilla Foundation
>
> April 25 (tbc)
> Linux Wochen Linz
> Presentation by Adam (linz, Austria)
>
> May 2-10
> Civi CRM BookSprint
> California, USA
> With CiviCRM
>
> May 3-6
> Society for Technical Communication
> Presentations about FLOSS Manuals by Janet Swisher, Anne Gentle, Scott
> Able
> Atlanta, USA
>
> May 27-20
> Net Squared Conf
> San Jose, USA
> Adam Attending
>
> June 22-27
> Open Translation Tools Book Sprint
> Amsterdam (at De Waag)
> With Aspiration Technology
>
>
>
> i'm sure there will be more confirmed within the next weeks...
>
> adam
>
>
>
>
>
>
> --
> Adam Hyde
> Founder FLOSS Manuals
> German mobile : + 49 15 2230 54563
> Email : adam at flossmanuals.net
> irc: irc.freenode.net #flossmanuals
>
> "Free manuals for free software"
> http://www.flossmanuals.net/about
>
>
>
>
> ------------------------------
>
> Message: 5
> Date: Thu, 9 Apr 2009 07:52:45 -0500
> From: Janet Swisher <jmswisher at gmail.com>
> Subject: Re: [FM Discuss] dates
> To: discuss at lists.flossmanuals.net
> Message-ID:
> <38c5f0150904090552i6b6574baq466122453cd44238 at mail.gmail.com>
> Content-Type: text/plain; charset="iso-8859-1"
>
> I'm happy to see so much activity.
>
> It would be really good to have a FLOSS Manuals presence at the "Writing
> Open Source" conference in Ontario, June 12-14. I'd love to go, but the
> airfare from TX is kinda steep. Is anybody from northeast US or eastern
> Canada interested?
>
> --Janet
>
> On Thu, Apr 9, 2009 at 6:19 AM, adam hyde <adam at flossmanuals.net> wrote:
>
> > heyhey,
> >
> > some dates :
> >
> > April 27-30
> > Possibly FireFox Book Sprint to continue the good work done at DocTrain
> > a few weeks ago, I am trying to get this confirmed at the moment
> > With the Mozilla Foundation
> >
> > April 25 (tbc)
> > Linux Wochen Linz
> > Presentation by Adam (linz, Austria)
> >
> > May 2-10
> > Civi CRM BookSprint
> > California, USA
> > With CiviCRM
> >
> > May 3-6
> > Society for Technical Communication
> > Presentations about FLOSS Manuals by Janet Swisher, Anne Gentle, Scott
> > Able
> > Atlanta, USA
> >
> > May 27-20
> > Net Squared Conf
> > San Jose, USA
> > Adam Attending
> >
> > June 22-27
> > Open Translation Tools Book Sprint
> > Amsterdam (at De Waag)
> > With Aspiration Technology
> >
> >
> >
> > i'm sure there will be more confirmed within the next weeks...
> >
> > adam
> >
> >
> >
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
<http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/attachments/20090409/1ff291f1/attachment-0001.htm>
>
> ------------------------------
>
> Message: 6
> Date: Thu, 09 Apr 2009 14:56:41 +0200
> From: adam hyde <adam at flossmanuals.net>
> Subject: Re: [FM Discuss] dates
> To: discuss at lists.flossmanuals.net
> Message-ID: <1239281801.12423.115.camel at esetera>
> Content-Type: text/plain
>
> i was thinking of going but its airfare + 300 USD
>
> thats getting costly for me
>
> i'm also organising an event with Michael Mandiberg in NYC, I hope we
> can send some details soon. It was orginally going to be about free
> documentation, but we thought it might have broader appeal if it was
> focused on open publishing...i'll send details as soon as possible
>
> adam
>
>
> On Thu, 2009-04-09 at 07:52 -0500, Janet Swisher wrote:
> > I'm happy to see so much activity.
> >
> > It would be really good to have a FLOSS Manuals presence at the
> > "Writing Open Source" conference in Ontario, June 12-14. I'd love to
> > go, but the airfare from TX is kinda steep. Is anybody from northeast
> > US or eastern Canada interested?
> >
> > --Janet
> >
> > On Thu, Apr 9, 2009 at 6:19 AM, adam hyde <adam at flossmanuals.net>
> > wrote:
> > heyhey,
> >
> > some dates :
> >
> > April 27-30
> > Possibly FireFox Book Sprint to continue the good work done at
> > DocTrain
> > a few weeks ago, I am trying to get this confirmed at the
> > moment
> > With the Mozilla Foundation
> >
> > April 25 (tbc)
> > Linux Wochen Linz
> > Presentation by Adam (linz, Austria)
> >
> > May 2-10
> > Civi CRM BookSprint
> > California, USA
> > With CiviCRM
> >
> > May 3-6
> > Society for Technical Communication
> > Presentations about FLOSS Manuals by Janet Swisher, Anne
> > Gentle, Scott
> > Able
> > Atlanta, USA
> >
> > May 27-20
> > Net Squared Conf
> > San Jose, USA
> > Adam Attending
> >
> > June 22-27
> > Open Translation Tools Book Sprint
> > Amsterdam (at De Waag)
> > With Aspiration Technology
> >
> >
> >
> > i'm sure there will be more confirmed within the next weeks...
> >
> > adam
> >
> >
> >
> > _______________________________________________
> > Discuss mailing list
> > Discuss at lists.flossmanuals.net
> > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> --
> Adam Hyde
> Founder FLOSS Manuals
> German mobile : + 49 15 2230 54563
> Email : adam at flossmanuals.net
> irc: irc.freenode.net #flossmanuals
>
> "Free manuals for free software"
> http://www.flossmanuals.net/about
>
>
>
>
> ------------------------------
>
> Message: 7
> Date: Thu, 9 Apr 2009 10:26:23 -0400 (EDT)
> From: Andy Oram <andyo at oreilly.com>
> Subject: Re: [FM Discuss] command line manual - please have a squiz
> To: discuss at lists.flossmanuals.net
> Message-ID:
> <23686280.212501239287183143.JavaMail.root at ball.east.ora.com>
> Content-Type: text/plain; charset=utf-8
>
> Thanks for compliments, Adam. I do think I helped. The original outline held
up really well. I think it as important not just to give people slots to fill
in, but to direct their thinking. For instance, "gee, if you're serious about
using the command line, you'd better learn a text editor, shouldn't you?"
>
> I was trying to set a framework for a broad and helpful way of thinking
about readers and their needs.
>
> So I wonder how much the surprisingly high quality of contributions were due
to setting the right expectations, and how much were due to luck.
>
> And I added a ton of material, both things that were missing and glue for
material that was good.
>
> On CiviCRM, I am keeping track of my time so I find out how much of a
commitment I need to make on a typical project of this type.
>
> Andy
>
> ----- Original Message -----
> From: "adam hyde" <adam at flossmanuals.net>
> To: "floss" <discuss at lists.flossmanuals.net>
> Sent: Thursday, April 9, 2009 6:42:00 AM GMT -05:00 US/Canada Eastern
> Subject: [FM Discuss] command line manual - please have a squiz
>
> soooo....the rather amazing command line manual is pretty much good to
> go...we will send to the FSF and they will print 200 and give us the $
> which in turn goes towards another collab sprint with the FSF...
>
> there has been some amazing contribs to this manual and no little thanks
> to andy for being the master maintainer for the manual...it looks and
> reads fantastico!
>
> there is a copy of the pdf here:
> http://adam.engagetv.com/cli/
>
> this will go to the printer. there might be a few tweaks, but this is
> pretty much it
>
> last call for feedback...
>
> adam
>
>
>
>
> --
> Adam Hyde
> Founder FLOSS Manuals
> German mobile : + 49 15 2230 54563
> Email : adam at flossmanuals.net
> irc: irc.freenode.net #flossmanuals
>
> "Free manuals for free software"
> http://www.flossmanuals.net/about
>
>
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>
> --
> ----------------------------------------------------------------------
> Andy Oram O'Reilly Media email: andyo at oreilly.com
> Editor 10 Fawcett Street, Fourth Floor voice: 617-499-7479
> Cambridge, MA 02138-1175, USA fax: 617-661-1116
> identi.ca/Twitter:praxagora http://www.praxagora.com/andyo/
> ----------------------------------------------------------------------
>
>
> ------------------------------
>
> Message: 8
> Date: Thu, 09 Apr 2009 16:48:36 +0200
> From: Luka Frelih <luka at ljudmila.org>
> Subject: Re: [FM Discuss] command line manual - please have a squiz
> To: discuss at lists.flossmanuals.net
> Message-ID: <49DE0AC4.5040000 at ljudmila.org>
> Content-Type: text/plain; charset=ISO-8859-1; format=flowed
>
> heya!
>
> great book, nice catch fixing the pre bold font.
>
> on page 77 (advanced part toc) gnu screen lost the space between words
>
> in regexp chapter, "fuzzy matching" is used where i guess "pattern
> matching" is more appropriate.
> i understand fuzzy to mean approximate matching, using soundex or
> levenshtein distances to find similar strings, like in typo correction
> or spellchecking.
>
> perhaps it would be nice to mention the rpl command in the sed chapter?
> i know it's not installed by default but it's a more user friendly way
> to perform basic search and replace, which is usually the first reason
> to use sed in a command line
>
> also not sure why (looks like some font encoding foo?) but try
> copy-pasting everything from evince to a text editor. i get mostly a lot
> of greek-letter garbage. this also makes searching in the manual find
> only things in courier.
>
> best,
> LF
>
> adam hyde wrote:
> > soooo....the rather amazing command line manual is pretty much good to
> > go...we will send to the FSF and they will print 200 and give us the $
> > which in turn goes towards another collab sprint with the FSF...
> >
> > there has been some amazing contribs to this manual and no little thanks
> > to andy for being the master maintainer for the manual...it looks and
> > reads fantastico!
> >
> > there is a copy of the pdf here:
> > http://adam.engagetv.com/cli/
> >
> > this will go to the printer. there might be a few tweaks, but this is
> > pretty much it
> >
> > last call for feedback...
> >
> > adam
> >
> >
> >
> >
> >
>
>
>
> ------------------------------
>
> Message: 9
> Date: Thu, 09 Apr 2009 16:56:47 +0200
> From: adam hyde <adam at flossmanuals.net>
> Subject: Re: [FM Discuss] command line manual - please have a squiz
> To: discuss at lists.flossmanuals.net
> Message-ID: <1239289007.7849.22.camel at esetera>
> Content-Type: text/plain
>
> hey,
>
> It was a very interesting sprint. Of course you made a huge positive
> contribution to it Andy. It might be interesting to compare the results
> of the How to Bypass Internet Censorship manual with the Command Line
> manuals as I think they both arrive at a similar level, but through
> quite different processes.
>
> The Bypassing process relied heavily on internal realspace conversations
> to structure the content, while the CLI manual largely relied on you to
> structure the content as most contributors were remote.
>
> Putting the structure of the content aside for a moment, my experience
> so far from witnessing all the sprints closely, is that there are two
> key elements to this process :
> 1. trust
> 2. explicit and implicit illustration of the desired tone and scope
>
> Luck comes into it of course, but I see that as a raw material from
> which we are learning to derive good content.
>
> adam
>
>
>
> On Thu, 2009-04-09 at 10:26 -0400, Andy Oram wrote:
> > Thanks for compliments, Adam. I do think I helped. The original outline
held up really well. I think it as important not just to give people slots to
fill in, but to direct their thinking. For instance, "gee, if you're serious
about using the command line, you'd better learn a text editor, shouldn't you?"
> >
> > I was trying to set a framework for a broad and helpful way of thinking
about readers and their needs.
> >
> > So I wonder how much the surprisingly high quality of contributions were
due to setting the right expectations, and how much were due to luck.
> >
> > And I added a ton of material, both things that were missing and glue for
material that was good.
> >
> > On CiviCRM, I am keeping track of my time so I find out how much of a
commitment I need to make on a typical project of this type.
> >
> > Andy
> >
> > ----- Original Message -----
> > From: "adam hyde" <adam at flossmanuals.net>
> > To: "floss" <discuss at lists.flossmanuals.net>
> > Sent: Thursday, April 9, 2009 6:42:00 AM GMT -05:00 US/Canada Eastern
> > Subject: [FM Discuss] command line manual - please have a squiz
> >
> > soooo....the rather amazing command line manual is pretty much good to
> > go...we will send to the FSF and they will print 200 and give us the $
> > which in turn goes towards another collab sprint with the FSF...
> >
> > there has been some amazing contribs to this manual and no little thanks
> > to andy for being the master maintainer for the manual...it looks and
> > reads fantastico!
> >
> > there is a copy of the pdf here:
> > http://adam.engagetv.com/cli/
> >
> > this will go to the printer. there might be a few tweaks, but this is
> > pretty much it
> >
> > last call for feedback...
> >
> > adam
> >
> >
> >
> >
> > --
> > Adam Hyde
> > Founder FLOSS Manuals
> > German mobile : + 49 15 2230 54563
> > Email : adam at flossmanuals.net
> > irc: irc.freenode.net #flossmanuals
> >
> > "Free manuals for free software"
> > http://www.flossmanuals.net/about
> >
> >
> > _______________________________________________
> > Discuss mailing list
> > Discuss at lists.flossmanuals.net
> > http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> >
> --
> Adam Hyde
> Founder FLOSS Manuals
> German mobile : + 49 15 2230 54563
> Email : adam at flossmanuals.net
> irc: irc.freenode.net #flossmanuals
>
> "Free manuals for free software"
> http://www.flossmanuals.net/about
>
>
>
>
> ------------------------------
>
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>
>
> End of Discuss Digest, Vol 23, Issue 17
> ***************************************
>
--
-- David McMurrey
Business & Technical Communications
Austin Community College
512.223.4804 - davidm at austincc.edu
More information about the Discuss
mailing list