logo       

Re: why hide the docs?: msg#00217

Subject: Re: why hide the docs?
On Thu, Nov 25, 2004 at 09:51:56AM +0100, Jorge Salgueiro wrote :
> a good thing indeed! Maybe a tool that would make a extensive menu entry 
> 
> 
> On Thu, 25 Nov 2004 07:24:06 +0200, Aaron <aamehl@xxxxxxxxxxxxx> wrote:
> > 
> > > There's already a lot of documentation anyhow, just look in:
> > >
> > > /usr/share/doc/<package>
> > 
> > couldn't a script be written to create a docs directory by searching
> > /usr/share/doc for *.html and creating the proper links?

I have done such kind of thing  for the A/DeMuDi live cd (1.1.0). I have
to clean thinks etc... Unfortunatly, I ahve very few time now (if not no
time at  all) to take  up on  this task. I  think that we  (however that
means) should start to work  on the organisation of such a documentation
(which is the most important  part IMO) and then organise the collection
of the docs wherever they are (provided they are Open/Free Content to be
distributable within A/DeMuDi). There is also some glue text to write to
put  pack the  whole  thing together  (I  would keep  this  as small  as
possible at the begining to  allow an incrementale work: trying to start
to high could block the work (as it is for the Agnula book).

It  doesn't have  to be  directly connected  to A/DeMuDi  but  of course
documentation  for  software which  are  in  A/DeMuDi  is better.   More
general documentation such as (out of my mind):


- Miller  Puckette  "Theory  and  Techniques of  Electronic  Music"  (pd
centered)[-1] ( i am unsure of the license of this one)
- Davide Rocchesso "Introduction to Sound Processing" [1]
- Marco Sacco "Corso Audio Multimediale" (right now only in italian)

could also be some nice inclusions (speak out for more)


Also tutorials such as Dave one are also of great value. 

Any volonteer to manage such a project? 

cheers,
damien

[-1] http://www-crca.ucsd.edu/~msp/techniques/latest/book-html/
[0] http://www.mondo-estremo.com/publications/publications/public.html
[1] http://audiosonica.blog.excite.it/permalink/60459

> > 
> > I am not such a script writer and I know how to search for
> > /usr/share/doc but a newbie won't and a windows user trying out demudi
> > would have a much easier job of it.
> > 
> > I am not talking about adding information but just making existing
> > information available.
> > 
> > I guess if no one else will do it I can do it for fluxbox for myself and
> > then post the information.
> > 
> > I wouldn't know how to do it for kde.
> > 
> > the toots are they available as a tar.gz??
> > 
> > Aaron
> > 
> > 
> > >
> > > and the Right Way (tm) to add additional information (e.g. the docs on
> > > the web site)  would be to send them  to the Debian maintainer of  the
> > > relevant package.  Is  something that anybody  can do  and would be  a
> > > valuable contribution.
> > >
> > > Cheers,
> > >
> > > Free
> > >
> > >
> > > _______________________________________________
> > > Users mailing list
> > > Users@xxxxxxxxxxxxxxxx
> > > http://lists.agnula.org/cgi-bin/mailman/listinfo/users
> > 
> > _______________________________________________
> > Users mailing list
> > Users@xxxxxxxxxxxxxxxx
> > http://lists.agnula.org/cgi-bin/mailman/listinfo/users
> >
> _______________________________________________
> Users mailing list
> Users@xxxxxxxxxxxxxxxx
> http://lists.agnula.org/cgi-bin/mailman/listinfo/users
> 
> 


<Prev in Thread] Current Thread [Next in Thread>