POV-Ray : Newsgroups : povray.general : [Idea] User Documentation Project : Re: [Idea] User Documentation Project Server Time
10 Aug 2024 21:03:12 EDT (-0400)
  Re: [Idea] User Documentation Project  
From: David Wilkinson
Date: 27 Dec 1998 11:13:21
Message: <368b5837.7730981@news.povray.org>
On Sun, 27 Dec 1998 06:58:04 -0800, Dan Connelly <djc### [at] flashnet>
wrote:
>
>.... as Ken so often and rightfully points out, there is a tremendous
>wealth of information in the example files.  Just rendering each of them,
>and then examining the source code, is in itself an excellent tutorial.
>It is well worth the time.  But many of the questions posted by users
>to these groups reveal that it is not a sufficiently exploited resource.
>
>You can lead a horse to water....
>
>Dan

OK point taken, but  rendering the example files takes time and they
are not necessarily relevant to the problem you have in hand.  A
textual guide to the example files would help a great deal.

I have just rendered (again) all four of  the examples in scenes\CSG
and find that they emphasise interesting textures rather than clearly
showing the way that CSG operations can be used.  This just helps to
convince me that an objective look at on improving documentation would
be well worthwhile.

I don't want to criticise POV-Ray developers who are doing a
magnificent job - for which I am sincerely grateful. I just believe
that the POV-Ray community could help to make POV-Ray even more
accessible.  If, for instance, each contributed something of  their
own particular expertise, perhaps by a simplified and well commented
example, it would be a great help to many of us.

David
"No man but a blockhead ever wrote, except for money." Samuel Johnson

dav### [at] cwcomnet
http://www.hamiltonite.mcmail.com


Post a reply to this message

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