given the enthusiasm for this from a number of fronts, expect more
formal thoughts from the two of us in the next few weeks. and while
you're dreaming of sugarplums, dream of your own chapter in the osg
gems book. :) happy holidays!
bob
On Dec 19, 2007, at 3:34 PM, sherman wilcox wrote:
Reading this thread, and the threads just like this which pop every
six months or so, What is clear is that :
1) When new documentation is announced it is appreciated, but...
2) Very shortly after users come forward and decry how unsufficient
the documentation we have... this
takes
Thanks for the enjoyable discussion. Bob and I will meet in about 2 weeks
and future documentation plans will be a topic of discussion.
Some random thoughts follow.
Free documentation... I charge for documentation I develop, just like I
charge for software I develop. I don't think this is
I rather like the idea of community donated white papers, with two
pro's editing and compiling them. It seems this would be quick,
and bring together a wide range of experiences.
I'd be happy to do the chapter OSG for Dummies... I'll throw in a
bonus section on mailing list etiquette ;-)
I'd be happy to do the chapter OSG for Dummies...
We were counting on you for OSG SuperBible! :-)
-Paul
___
osg-users mailing list
osg-users@lists.openscenegraph.org
http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
Yikes... I'm already loosing sleep about all the work I have ahead
because of OpenGL 3.0 ;-)
Richard
On Dec 19, 2007, at 2:39 PM, Paul Martz wrote:
I'd be happy to do the chapter OSG for Dummies...
We were counting on you for OSG SuperBible! :-)
-Paul
However, I like the idea of a community-written OSG Gems book, and I don't
want to underestimate the community's willingness to contribute. So, I'll
give this some thought, look into other Gems-style books' business models,
and see if I can find a way to make this work (time-wise, as an
- Original Message
From: Robert Osfield [EMAIL PROTECTED]
To: OpenSceneGraph Users osg-users@lists.openscenegraph.org
Sent: Friday, December 14, 2007 3:05:38 PM
Subject: Re: [osg-users] ANN: Reference Manual for v2.2 now available
On Dec 14, 2007 7:59 PM, Zachary Hilbun wrote
Subject: Re: [osg-users] ANN: Reference Manual for v2.2 now available
...
If it were me paying for parts of the OSG to be developed I would want
to pay extra to have it documented properly. My opinion would be that
it is cheaper to pay the writer to document it properly than to pay my
employes
Osfield [EMAIL PROTECTED]
To: OpenSceneGraph Users osg-users@lists.openscenegraph.org
Sent: Friday, December 14, 2007 3:05:38 PM
Subject: Re: [osg-users] ANN: Reference Manual for v2.2 now available
On Dec 14, 2007 7:59 PM, Zachary Hilbun wrote:
To me an API is only as good as it's
Apparently I ran on and on and tried to be too clever and should have
just stayed quiet. I did not intend to further the debate, but perhaps
capture the nature of open source and community driven projects for
those who can't understand why OSG isn't as easy to pick up as say Qt.
This
I haven't been tempted by the reference manual book because I know
how to navigate
the source code and can't see how the relatively sparse comments
therein would be
more helpful compiled together. I think the situation is even worse
once you get
i thought this would be my experience
HI Bob,
On Dec 17, 2007 2:18 PM, Bob Kuehne [EMAIL PROTECTED] wrote:
i thought this would be my experience too, after writing it, but i've
been surprised. simply seeing all the methods laid out in a logical
fashion (rather than how they might be typed into the header), seeing
the
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Paul Martz wrote:
Let me throw out some ideas, which Bob and I have discussed in the past and
also mentioned here on osg-users...
* The reference manual, as it stands today, contains some nice
supplementary material, but in essence it's Doxygen
Hi Tim,
On Dec 15, 2007 9:20 AM, Tim Moore [EMAIL PROTECTED] wrote:
* We could embark on the much-promised and long-awaited Programming
Guide. Again, this is a big job and only seems worthwhile if we focus our
efforts on stable features.
I'd love to see this and I know it would be a big
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Robert Osfield wrote:
Hi Tim,
On Dec 15, 2007 9:20 AM, Tim Moore [EMAIL PROTECTED] wrote:
* We could embark on the much-promised and long-awaited Programming
Guide. Again, this is a big job and only seems worthwhile if we focus our
efforts on
Let me throw out some ideas, which Bob and I have discussed in the past and
also mentioned here on osg-users...
* The reference manual, as it stands today, contains some nice
supplementary material, but in essence it's Doxygen output from the source
code. We could beef up the source code
Paul Martz wrote:
* We could spend time writing short whitepapers on various OSG topics,
I'd be very much in favour of this form of documentation.
It allows users to pick and choose which papers to read, without having to buy
lots of doxygen output or stuff they already know.
Domain experts
Hello Bob and Paul,
* The reference manual, as it stands today, contains some nice
supplementary material, but in essence it's Doxygen output from the source
code. We could beef up the source code comments for classes and functions,
and contribute this back to osg-submissions. This would
On Dec 14, 2007 7:59 PM, Zachary Hilbun [EMAIL PROTECTED] wrote:
To me an API is only as good as it's documentation.
I'd suggest that the OSG is proof that point of view is a perhaps just
a little flawed.
Good documentation but a poor API and implementation don't make for
successful end user
I'm really excited about this, especially the inclusion of the environment
variable reference (which you've seen me pouring my sweat in to these past
few weeks). Previously undocumented, OSG's environment variables are a
powerful debugging and tuning mechanism that all OSG developers should be
Nice work, thanks for the effort I so much like a dog eared book of a man or
web page ;)
_
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On Behalf Of Paul Martz
Sent: Thursday, December 13, 2007 9:40 AM
To: 'OpenSceneGraph Users'
Subject: [osg-users] ANN: Reference Manual for v2.2
let me pile on and say i'm thrilled we're done with this too. :)
i'd also ask of all those users out there who are interested in better
documentation to send us an email: [EMAIL PROTECTED] - tell us what
would is most important to you in our next book. what you'd like to
see, what you think
23 matches
Mail list logo