Thursday, November 29 - Scott M Stark said:
> Your free to write documentation and give it away as is anyone else.
> So let me get this straight, you expect that because I write code for
> free, document its API, and answer developer questions about it, I
> must also write production quality documentation for free?
> 

  Why not write and distribute production quality documentation for free, 
  then charge $10 bucks for the code?  I mean, it's the same difference -
  you can't really use one without the other. But that way, no one could 
  complain about poor documentation... and those who want their cake and 
  eat it too will of course be free to write code and give it away.

  The usual model is, whatever professional quality documentation written,
  would be provided free in electronic form, and then charged for the 
  hard-copy version which often includes more in-depth information and 
  chapters/diagrams/references and whatnot.


> 
> The model for the book and documentation is that we are going to only
> support the professional documentation.
> 
> Free documentation is just too hard, the guys who write it usually do it and
> leave, it comes under heavy criticism still today (see theserverside.com
> thread) and generally has been a pain. I have had enough of it.
> 

  Perhaps the free documentation simply needs a more controlled/moderated
  organized effort to be spearheaded, rather than giving up on it entirely.


> We are going to a model where you pay for the documentation, the free doco 
> is just going to die. I don't think I will even distribute it any more.
>

  You're even going to ditch the current free docs??

  Ouch.

  An action like that is only going to hurt jboss - not help it.


> Take Dain's stuff, you can use the product for free but if you want the
> documentation for it you are going to pay $5 for Dain's documentation, same
> for the clustering you are going to be paying for Sacha's documentation.
> All the features are there in the free product but if you want the
> documentation we are going to sell it for a fee.  
>

  How many people do you really think are going to *use* the product
  if you don't provide the documentation that tells them *how* to use 
  it?

  What you should be selling for a fee, should be *extra* documentation,
  or *extra features*, or extra *support*. If you really want to see
  jboss gain some serious momentum amongst an even wider user-base, you
  have to at least bundle some decent, accurate and moderately timely
  documentation with it - even if those docs are pretty sparse and terse 
  overviews. Something to allow people to digest enough to get the thing 
  installed, basically configured, and running a simple default app.

  *Then* point them to the meaty, detailed docs they can purchase once 
  they're satisfied with the product.


<snip>
> (i don't want 3rd party writting doco and making money of it) 
<snip> 

  Why the hell not?

  Imagine if Sun had taken that attitude with java, or Linus with linux, 
  or Apache with apache...


> simple, will work, is already working, we are selling.
> 
> "The meal is free, the service is not included"
> 

  More like: "The parts are free, the instructions are not included."

  There's a distinct difference - without the instructions, the parts
  become less usefull, if not totally useless altogether. 

  "Here's your kick-ass, super featured, way-ahead-of-the-competition 
  software, FREE! But good luck trying to ever figure out how to get it 
  to do anything... unless you want to buy the Documentation first!"


> This is a simple way to make some money FOR THE DEVELOPERS OF THE FEATURES
> and grow professionally.
>

  And for the most part it's a great idea - but you really odda consider
  providing some decent enough docs at least for people to get started on, 
  otherwise I imagine you'll find alot of people never getting started at 
  all...


> If the guys reading the statement are too cheap to shell out $10 for the
> documentation I am really not going to worry about them, I am not very
> concerned about them.  In fact I want them gone,
> 

  I doubt it's simply the 10 bucks ( although in many cases it very well
  may be - which is what I thought was so cool about open source ), but
  what sort of attitude is that anyways? 
  
  Anyhow - I certainly haven't donated anything at all towards jboss other 
  than good words to my professional peers, so my opinions certainly don't
  weigh much. Having said that, JBoss is way cool, and so are the folks who 
  have spent their valuable time developing it. 


Beers,

Corey



_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development

Reply via email to