writing spk howto (?)

[Janina Sajka]

Precisely. And Kirk is the boss.

Sean McMahon writes:
> While we're on the subject of writing howtos, is there some process for getting
> these things on the speakup site?  Is there a general cvs project or aria for
> documentation     of speakup?
> Sean
> ----- Original Message ----- 
> From: "Janina Sajka" <janina at rednote.net>
> To: <david at bruzos.org>; "Speakup is a screen review system for Linux."
> <speakup at braille.uwo.ca>
> Sent: Tuesday, November 02, 2004 6:18 AM
> Subject: Re: writing spk howto (?)
> 
> 
> > Absolutely, you should do a Speakup with Software Speech HOWTO. The
> > community needs one desparately, and there aren't enough of us document
> > writers to go around.
> >
> > In all honesty, I must tell you that writing a clear, concise, and
> > complete HOWTO is hard work. I don't say this to discourage you, but to
> > point out that there's a reason why more HOWTOs aren't just out there to
> > be plucked off the net. My advice is to start simple, and Speakup With
> > Software Speech sounds to me like about the right task.
> >
> > I will tell you that I attempted to write a HOWTO for Speakup on Linux
> > together with a professional tech writer from IBM. When the tech writer
> > left IBM this project stalled--after over 6 months of work between us.
> > That's when I took the pieces that I actually knew something about and
> > created the Installation HOWTO for the Speakup Modified Fedora Core.
> >
> > Which reminds me, writing a HOWTO is only part of the job. The rest of
> > the job is maintaining the HOWTO which means making new versions when
> > new facts change the advice people need to have.
> >
> >
> >
> > David Bruzos writes:
> > >
> > > Hello everyone:
> > > This is my first time posting to this mailing list.  I have come here many
> times before to find info about Linux and
> > > Speakup. I have a running system largely due to the existence of this list.
> So, first, I like to thank the people that
> > > organize it and everyone involved in Speakup for their work.  Kirk is the
> man!
> > >
> > > Last week I searched through the archives for hours to find out how to
> configure my software synth.  I saw, among other
> > > things that there are no howtos for discribing this process and that most of
> the documentation is somewhat outdated.
> > > Anyway, it would have been much earier for me to setup software speech if
> there would have been an organized guide or
> > > howto, that explains how to do it...  I am sure that this is no news to most
> people in this list!
> > >
> > > So, I figured that now that I know how to do it, I can put together such a
> document.  In fact, I would like to
> > > contribute by doing this.  I can not program well enough to improve speakup,
> but I could help out with the docs.  I
> > > would like to write a general Linux/Speakup howto, but I can not promise
> that I can finish something like that any time
> > > soon.  So, the software synth thing is a better short term goal.  I am a
> full-time student at the University of North
> > > Florida and soon to be a Dad, so time might be a problem in the
> > > comming weeks...
> > >
> > > I would like to know what other mailing list members think about this.  Are
> there some reasons why I should not do this?
> > > Are there other people working on a similar project?  Anywthing is cool.
> Oh, I am also a Linux newbey, so I might ask
> > > simple questions sometimes...
> > >
> > > I am 23 years old and totally blind, so speakup is very important for me.  I
> have been using Linux for about one year
> > > and used Windows/jfw before that.  I started with Fedora Core 1 and now use
> > > Fedora Core 2 and Mandrake 10 as well.  The reason for Mandrake is so that I
> can help my father when required...
> > >
> > > Thanx!
> > >
> > > David
> > >
> > >
> > > _______________________________________________
> > > Speakup mailing list
> > > Speakup at braille.uwo.ca
> > > http://speech.braille.uwo.ca/mailman/listinfo/speakup
> >
> > -- 
> >
> > Janina Sajka, Chair
> > Accessibility Workgroup
> > Free Standards Group (FSG)
> >
> > janina at freestandards.org Phone: +1 202.494.7040
> >
> >
> > _______________________________________________
> > Speakup mailing list
> > Speakup at braille.uwo.ca
> > http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 
> 
> _______________________________________________
> Speakup mailing list
> Speakup at braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup

-- 
	
				Janina Sajka, Chair
				Accessibility Workgroup
				Free Standards Group (FSG)

janina at freestandards.org	Phone: +1 202.494.7040