Rebecca Jean Pedersen wrote:
> I figured since everyone is talking help files I would just introduce
> myself. I'm on IRC as bex and I'm willing to help however I can. I'm
> somewhat new to gimp, so I won't be much good for writing new help
> files, but my education is in English, especially writing, so I have
> volunteered to proofread and edit documents.
Don't sell yourself short. People very, very, familiar with a topic
often "forget what they know" and, consequently, fail to properly stage
concepts for the best comprehension of newcomers. On a number of occasions
I have read exposition from newcomers to a topic of much higher caliber
than that coming from acknowledged experts. The learning experience is still
fresh to newcomers and they still remember the sequences of concepts that
lead to their own "Eurekas!" and can relate these to fellow newcomers.
Old hands often disassemble the scaffolding of their understanding once
the framework is complete, so they have no idea how to explain what they've
come to know.
Jarda Benkovsky wrote:
> If I may add some points in favor of DocBook:
> - consistency - it will help make the pages the same style
> - easy change of style in all pages at once
> - I believe it's simpler than full-blown HTML (CSS ....)
I'm inclined to agree. I find flat HTML documentation is hard to
maintain. As much as possible writers should concentrate on content
and leave issues of appearance of formatting, packaging, and delivery
to downstream release mechanisms.
My two U. S. cents
Be good, be well