OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

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

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.

----- 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
> http://www.dpawson.co.uk 

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]