POV-Ray : Newsgroups : povray.off-topic : Open Source Documentation : Re: Open Source Documentation Server Time
6 Sep 2024 07:16:05 EDT (-0400)
  Re: Open Source Documentation  
From: Patrick Elliott
Date: 6 Feb 2009 23:20:27
Message: <498d0c0b@news.povray.org>
Darren New wrote:
> You gotta love some of the open source documentation out there.  I'm 
> learning Blender right now, and some of the docs are kind of amusing. 
> (They'd be downright annoying if it was commercial software, mind.)
> Makes you appreciate POV-Ray docs.
> 
> """
> I don't know what this parameter does, but I've played around with it 
> and gotten pictures like this...
> """
> I gotta wonder who would implement some change and not at least leave a 
> note that says what the change is supposed to do.
> 
> 
> Another classic favorite:
> """
> The XYZ parameter replaces the old PDQ technique, making it faster and 
> easier to get the same results."
> """
> ... which is great, if you've been using the software long enough to 
> know what the PDQ technique was supposed to do. At least leave the 
> documentation in for PDQ. :-)
> 
> 
> I know most programmers don't like to write documentation, but it's 
> always a little jarring to me to run across something like that.
> 
Ah, well. The interface is, in some ways, just as jarring as the 
documentation, so, its a good match. ;) lol

-- 
void main () {
   If Schrödingers_cat is alive or version > 98 {
     if version = "Vista" {
       call slow_by_half();
       call DRM_everything();
     }
     call functional_code();
   }
   else
     call crash_windows();
}

<A HREF='http://www.daz3d.com/index.php?refid=16130551'>Get 3D Models, 
3D Content, and 3D Software at DAZ3D!</A>


Post a reply to this message

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