Re: [as-devel] Trying to access as-users

Jeff Krebs (jkrebs@tconl.com)
Sat, 24 Feb 2007 08:53:08 -0600 

If you're goiung to do SIGNIFICANT changes, you'll probably want to
chat on IRC #afterstep.  There's a fellow on there, born2late, who
coordinates the cvs documentation.

What needs work?  Looking through the AS docs (on 2.2.4, go to the
"About AfterStep/AfterStep Documentation" area on the menu) you'll
find many items with:

	FIXME: add proper description here.

One page that has a couple is:

	file:///usr/share/afterstep/doc/html/Look.html

I think the best thing to do is get a direction from Niklas and go.
I'm sure he has many things that need work.  ANY positive contributions
will be welcome.  If you are up to working with docbook xml snippets,
great.  If you need to do things in raw text, that's probably do-able
too.  Get with Niklas on this.

Jeff


* anonymous linguist (linguistics.meister@googlemail.com) wrote:
> Thanks so much for getting as-users fixed, jeff. That's really
> helpful. While it was down not only could I not join, but a lot of the
> google hits I got had page not found errors, which was really
> frustrating.
> 
> >doc is generated from src/ASDocGen/ found in the source tarball / cvs.
> >everything is generated from docbook xml snipplets in the source subdir
> >(faq is also in there). anything you submit here will be in all supported
> >docformats (xml, html, php, man, txt).
> 
> Do I submit changes by producing docbook snippets and posting them
> here? Sorry if that's a stupid question but I haven't worked on a
> project like this before so it's all new to me.
> 
> >_anything_ that makes the intro part better is welcome and will be
> >integrated into docs !
> Are you most interested in changes to the visualselect4html stuff or
> in general? I think I found the visualselect stuff pretty helpful.
> What really caught me was when I wanted to start making changes and I
> couldn't figure out what various options did (either because they
> hadn't been added yet or because I didn't have enough background
> knowledge to fully understand the explanation), or where I made a
> change but there was some interacting thing I also needed to change
> but I didn't know what it was.
> 
> 
> >apart from that, as jeff already said the wiki is for other stuff or if you
> >are too lazy to deal with me.
> Nope, I'll deal with you.  :)  Wikis tend to be my last port of call,
> so on the assumption that there are other people like me, I shall deal
> with you and try and produce stuff which will be integrated into the
> main docs.
> 
> I'm super-busy until the end of March [1] so for now I'll probably
> just collect my own observations on things I found unclear, and I'll
> start actually submitting stuff after that.
> 
> Thanks for the help!
> 
> L.M.
> 
> [1] Note to self: do not change window manager when you have an
> upcoming deadline.