RE: [asterisk-users] Manager Interface API's (OSS doc discussion)

2006-08-16 Thread Michael Collins
I guess I simply have a different viewpoint.  If I document, even
lightly, something that I give to the general public (or a specific
group within that general public), I feel I *WILL* get a ROI.  The more
people who use my 'gift' the better.  Who knows if someone will return
to me a snippet of code that makes my script/program even better?

The other thing is this: I looked at the Perl module Doug referenced.
It was uploaded to the CPAN, which means that it was meant to be shared
with the general public.  The documentation on this module is skeletal,
and that is a generous description.  (I also pored over the source and
found next to nothing in the way of documentation.) Fortunately the CPAN
allows authors to accept annotations - the annotated CPAN - which means
that a generous soul who has figured it out can post his knowledge for
everyone's benefit.  

As for the Python modules, I confess that I know nothing about them or
Python.

Bottom line: Free code w/o documentation should be disclaimed as such.
On the other hand, documentation is NEVER a bad thing.  Ever.  OSS
thrives when we share, not just code, but knowledge and ideas.  

-MC

 
 If I just made something that I needed...and then decided to release
it to
 the public incase anyone else needed it...I wouldn't waste my time
 documenting it...because there is no ROI to me for that
 
___
--Bandwidth and Colocation provided by Easynews.com --

asterisk-users mailing list
To UNSUBSCRIBE or update options visit:
   http://lists.digium.com/mailman/listinfo/asterisk-users


Re: [asterisk-users] Manager Interface API's (OSS doc discussion)

2006-08-16 Thread John Novack



Michael Collins wrote:

I guess I simply have a different viewpoint.  If I document, even
lightly, something that I give to the general public (or a specific
group within that general public), I feel I *WILL* get a ROI.  The more
people who use my 'gift' the better.  Who knows if someone will return
to me a snippet of code that makes my script/program even better?

The other thing is this: I looked at the Perl module Doug referenced.
It was uploaded to the CPAN, which means that it was meant to be shared
with the general public.  The documentation on this module is skeletal,
and that is a generous description.  (I also pored over the source and
found next to nothing in the way of documentation.) Fortunately the CPAN
allows authors to accept annotations - the annotated CPAN - which means
that a generous soul who has figured it out can post his knowledge for
everyone's benefit.  


As for the Python modules, I confess that I know nothing about them or
Python.

Bottom line: Free code w/o documentation should be disclaimed as such.
On the other hand, documentation is NEVER a bad thing.  Ever.  OSS
thrives when we share, not just code, but knowledge and ideas.  


-MC
  
Sir, you are a breath of fresh air. I can only hope your outlook and 
attitude are contagious in this community and the programming community 
in general


John Novack


If I just made something that I needed...and then decided to release


it to
  

the public incase anyone else needed it...I wouldn't waste my time
documenting it...because there is no ROI to me for that



___
--Bandwidth and Colocation provided by Easynews.com --

asterisk-users mailing list
To UNSUBSCRIBE or update options visit:
   http://lists.digium.com/mailman/listinfo/asterisk-users


  

___
--Bandwidth and Colocation provided by Easynews.com --

asterisk-users mailing list
To UNSUBSCRIBE or update options visit:
  http://lists.digium.com/mailman/listinfo/asterisk-users