[kepler-dev] Correction to Volunteer: Corrections to ...

[Matthew Jones]

Your contributions would be much appreciated, Glen.

We have contracted with a full-time technical writer to work on much of 
the documentaiton.  Kirsten has been coordinating all of the 
documentation issues, and has written or edited almost everything we 
have.  I'm sure she would be happy to get your revisions and feedback. 
She also will knwo exactly which of the versions are the most up-to-date 
for the Getting Started Guide.

Matt

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Matthew B. Jones
jones at nceas.ucsb.edu                Ph: 541-888-2581 ext. 287
National Center for Ecological Analysis and Synthesis (NCEAS)
UC Santa Barbara
http://www.nceas.ucsb.edu/ecoinformatics
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Ilkay Altintas wrote:
> Glen,
> 
> Thanks for wiling to help with the documentation.
> 
> Could you send us the link you obtained your version of the document  
> from?
> 
> It would be easier if you could send us your comments on the file  
> initially instead of updating the file directly as others are working  
> on it as well.
> 
> Thanks,
> -ilkay
> 
> 
> 
> On Mar 17, 2007, at 8:30 AM, Glen Jarvis wrote:
> 
>> An official email that suggests making correction to documentation
>> should be relatively error free. Because there were serious
>> grammatical errors in my previous email, please let me resend:
>>
>> As a student who is researching Kepler from the ground up, I've only
>> really read several web pages, the Ptolemy Overview and the "Getting
>> Started with Kepler" guide. This is beneficial because I'm seeing this
>> information freshly and still have that "fresh understanding."
>>
>> I have just joined the Kepler-Dev group and can only benefit the
>> community in one small way. I can take a few days to make corrections
>> to the "Getting Started with Kepler" guide. The file I have obtained
>> has no version numbering, but is 44 pages long and the filename is
>> "draft-getting-started-guide.pdf." If I do not have the current
>> version of this guide, please direct me to the new guide and disregard
>> the rest of this email.
>>
>> If this is the current version, I found several mistakes that I could
>> help with. Examples of items I noticed while freshly reviewing this
>> guide are:
>> * The "Image Converter" documentation states that it is not used in  
>> any demo,
>>    but, I found it in demo 3 "ImageDisplay.xml."
>> * When going through the examples, the "File to String Converter"  
>> was not
>>    found. However, the "FileReader" worked well in the example.
>> * There are several typos. For example, on page 30 we see "This
>> workflow adds a
>>    sting o..." where the word should be "string" not "sting."
>>
>> I found the guide very helpful in getting started. And, I'd like to
>> polish it and possibly get it out of draft status. The only thing I
>> don't know are the descriptions of each of the icons in section 5.3
>>
>> So, I ask, may I:
>> * Have an editable copy of this document so that I may make changes
>>    and submit it for review?
>> * Understand what documentation versioning schemes are used in the  
>> Kepler
>>    Project. "Overview of the Ptolemy Project" is simply dated. So,  
>> would
>>    version: 20070317 be appropriate?
>> * Have anyones advice and/or permission on proceeding with this?
>>
>> Warmest Regards,
>>
>>
>> Glen Jarvis
>> -- 
>> 913-486-8775
>> glen at glenjarvis.com
>> http://www.glenjarvis.com
>>
>> "You must be the change you wish to see in the world." -M. Gandhi
>> _______________________________________________
>> Kepler-dev mailing list
>> Kepler-dev at ecoinformatics.org
>> http://mercury.nceas.ucsb.edu/ecoinformatics/mailman/listinfo/ 
>> kepler-dev
> 
> _______________________________________________
> Kepler-dev mailing list
> Kepler-dev at ecoinformatics.org
> http://mercury.nceas.ucsb.edu/ecoinformatics/mailman/listinfo/kepler-dev