I think non-geek documentation is the way to go. Are you going to put it out
for review before it's finalised? I'd be happy to go through it as though I
were a brand new user. Particularly since I'm not using DocBook 5 yet.
John
----- Original Message -----
From: "Dave Pawson" <[EMAIL PROTECTED]>
To: "John New" <[EMAIL PROTECTED]>
Cc: "Docbook Apps" <[email protected]>
Sent: Saturday, February 09, 2008 8:46 PM
Subject: Re: [docbook-apps] Website. docbook v5? Documentation.
John New wrote:
Hi Dave,
I'm pretty much a general user of the website DTD. The kind of documents
I tried to find a while ago when I put my website together using the
website DTD were straightforward examples and "how-to" guides. Not so
much the technical stuff because, generally speaking, I like things to
work without too much trouble.
I didn't find a lot. The two resources that were most helpful were the
"contrived" annotated website example with comments and the website
chapter in Bob Stayton's book (of course, I found the entire book
excellent for other reasons). These put me on the right track so that I
could work out the easiest way to build and, more importantly,
automatically update my website.
Is your documentation going to have some of this higher level general
user step-by-step stuff? If you like, I can send you a small document I
wrote a while ago that summarises what I tried to do.
My audience is a non geek user, so I'll cover the
new site
add page
del page
mov page
that most users want.
I'll also address building website, from the non geek pov.
Then a small section on file naming /id values since
for this windows user they are causing problems.
What have I missed?
regards
--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
