POV-Ray : Newsgroups : povray.documentation.inbuilt : The docs stink. Server Time
15 May 2024 10:17:59 EDT (-0400)
  The docs stink. (Message 5 to 14 of 14)  
<<< Previous 4 Messages Goto Initial 10 Messages
From: Ben Chambers
Subject: Re: The docs stink.
Date: 5 Feb 2002 21:41:38
Message: <3c6097e2@news.povray.org>
"Tom Melly" <tom### [at] tomandlucouk> wrote in message
news:3c5fc236@news.povray.org...
> No, really. They smell of limburgh.

<snip>

Have you tried the context help (if you're using win pov)?  Hmm, I like
you're idea of two separate help files - how about a 'light' one with just
syntax, and a 'verbose' one with all the other stuff you might not
necessarily want for a quick refresh of the mind?  Of course, then new users
wouldn't want to read the complete docs, just the light one, and would get
annoyed by the docs not saying enough...

...Chambers


Post a reply to this message

From: Tom Melly
Subject: Re: The docs stink.
Date: 6 Feb 2002 04:54:42
Message: <3c60fd62$1@news.povray.org>
"Ben Chambers" <bdc### [at] yahoocom> wrote in message
news:3c6097e2@news.povray.org...
>
> Have you tried the context help (if you're using win pov)?

Yes - it tends to suffer from the same problem IIRC, in that it doesn't
necesserily take you to the basic syntax for the keyword.

>  Hmm, I like
> you're idea of two separate help files - how about a 'light' one with just
> syntax, and a 'verbose' one with all the other stuff you might not
> necessarily want for a quick refresh of the mind?  Of course, then new users
> wouldn't want to read the complete docs, just the light one, and would get
> annoyed by the docs not saying enough...

Ah, those lamers will always find something to bitch about ;)

Actually, I was thinking partly of the n.users, but it's true that there is
always a downside....


Post a reply to this message

From: Chris Cason
Subject: Re: The docs stink.
Date: 8 Feb 2002 22:43:26
Message: <3c649ade@news.povray.org>
"Tom Melly" <tom### [at] tomandlucouk> wrote in message news:3c5fef55$1@news.povray.org...

> Do you mean that the help-author gets no control over it at all?

correct (at least for windows HTML help).


Post a reply to this message

From: Thorsten Froehlich
Subject: Re: The docs stink.
Date: 9 Feb 2002 14:47:10
Message: <3c657cbe@news.povray.org>
In article <3c649ade@news.povray.org> , "Chris Cason" 
<newsadmin-despam-@povray-no-spam.org> wrote:

> "Tom Melly" <tom### [at] tomandlucouk> wrote in message
news:3c5fef55$1@news.povray.org...
>
>> Do you mean that the help-author gets no control over it at all?
>
> correct (at least for windows HTML help).

On Mac OS (also using HTML based help), the author has no control either :-(

    Thorsten

____________________________________________________
Thorsten Froehlich, Duisburg, Germany
e-mail: tho### [at] trfde

Visit POV-Ray on the web: http://mac.povray.org


Post a reply to this message

From: Bill DeWitt
Subject: Re: The docs stink.
Date: 9 Feb 2002 18:51:15
Message: <3c65b5f3$1@news.povray.org>
"Thorsten Froehlich" <tho### [at] trfde> wrote :
> >
> >> Do you mean that the help-author gets no control over it at all?
> >
> > correct (at least for windows HTML help).
>
> On Mac OS (also using HTML based help), the author has no control either
:-(

    Not even by weighting the items with keywords?


Post a reply to this message

From: Pabs
Subject: Re: The docs stink.
Date: 11 Feb 2002 02:28:17
Message: <3c677291@news.povray.org>
>     Not even by weighting the items with keywords?
for WinHelp (not HTMLHelp) you can add keywords to each topic (one page)


Post a reply to this message

From: Robert Chaffe
Subject: Re: The docs stink.
Date: 19 Feb 2002 23:19:58
Message: <3c7323ee@news.povray.org>
"Tom Melly" <tom### [at] tomandlucouk> wrote in message
news:3c5fc236@news.povray.org...
> No, really. They smell of limburgh.
>
> . . .
>
> 2. I sometimes wonder if the docs would be better split into two seperate
help
> files - a syntax and include file help and a tutorial help. I dunno, just
an
> idea. I'm probably being a bit lame, but, when I need to quickly check the
> syntax of an object/feature, it sometimes takes me a couple of goes, and a
shift
> in concentration, before I can find it in the docs.
>
> . . .

Critique the following:
http://www.donovansweb.com/~chaffe/quickref.html

Robert


Post a reply to this message

From: Tom Melly
Subject: Re: The docs stink.
Date: 20 Feb 2002 11:44:27
Message: <3c73d26b$1@news.povray.org>
"Robert Chaffe" <rob### [at] earthlinknet> wrote in message
news:3c7323ee@news.povray.org...
>
> Critique the following:
> http://www.donovansweb.com/~chaffe/quickref.html
>
> Robert

Wow, very nice.... any chance of a zip on the site incl. the "Notes" ?


Post a reply to this message

From: Robert Chaffe
Subject: Re: The docs stink.
Date: 20 Feb 2002 21:42:14
Message: <3c745e86@news.povray.org>
"Tom Melly" <tom### [at] tomandlucouk> wrote in message
news:3c73d26b$1@news.povray.org...
> "Robert Chaffe" <rob### [at] earthlinknet> wrote in message
> news:3c7323ee@news.povray.org...
> >
> > Critique the following:
> > http://www.donovansweb.com/~chaffe/quickref.html
> >
> > Robert
>
> Wow, very nice.... any chance of a zip on the site incl. the "Notes" ?
>

Glad you like it.

I have added a link to the file qr.zip near the top of the web page.  It's
just a zip of the associated files within a single folder, so ignore any
broken links.  I'll try to remember to update the zip whenever I update the
reference.

Robert


Post a reply to this message

From: ingo
Subject: Re: The docs stink.
Date: 21 Feb 2002 08:14:57
Message: <Xns91BC91437C674seed7@povray.org>
in news:3c7323ee@news.povray.org Robert Chaffe wrote:

> Critique the following:
> http://www.donovansweb.com/~chaffe/quickref.html
> 

This is very nice.

Ingo


Post a reply to this message

<<< Previous 4 Messages Goto Initial 10 Messages

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.