Re: [docbook-apps] Website. docbook v5? Documentation.

["John New" <johnn198@gmail.com>]

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" <davep@dpawson.co.uk>
To: "John New" <johnn198@gmail.com>
Cc: "Docbook Apps" <docbook-apps@lists.oasis-open.org>
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