Project

General

Profile

Actions

Bug #3976

closed

Update Documentation for 2.0 release

Added by Chad Berkley over 15 years ago. Updated over 14 years ago.

Status:
Resolved
Priority:
Immediate
Assignee:
Category:
documentation
Target version:
Start date:
04/13/2009
Due date:
% Done:

0%

Estimated time:
Bugzilla-Id:
3976

Description

Need to update the Getting Started Guide, the user guide and the actor reference with new 2.0 features.


Related issues

Blocks Kepler - Bug #4012: update documentation to explain adding actor to library via KARNewAaron Aaron04/22/2009

Actions
Blocks Kepler - Bug #4070: Rework Section 1 and the GSGResolvedChad Berkley05/18/2009

Actions
Blocks Kepler - Bug #4071: Rework Section 2ResolvedDavid Welker05/18/2009

Actions
Blocks Kepler - Bug #4072: Rework Section 3ResolvedDerik Barseghian05/18/2009

Actions
Blocks Kepler - Bug #4073: Rework Section 4ResolvedSean Riddle05/18/2009

Actions
Blocks Kepler - Bug #4074: Rework Section 5ResolvedChad Berkley05/18/2009

Actions
Blocks Kepler - Bug #4075: Rework Section 6ResolvedAaron Aaron05/18/2009

Actions
Blocks Kepler - Bug #4076: Rework Section 7Resolvedjianwu jianwu05/18/2009

Actions
Blocks Kepler - Bug #4077: Rework Section 8ResolvedChad Berkley05/18/2009

Actions
Blocks Kepler - Bug #4078: Rework Section 9ResolvedChad Berkley05/18/2009

Actions
Blocks Kepler - Bug #4079: Rework Section 10ResolvedChad Berkley05/18/2009

Actions
Blocks Kepler - Bug #4080: Rework Section 11ResolvedAaron Aaron05/18/2009

Actions
Blocks Kepler - Bug #4081: Rework Appendix BResolvedChad Berkley05/18/2009

Actions
Blocks Kepler - Bug #4082: New user guide section on modules/module managerResolvedDavid Welker05/18/2009

Actions
Blocks Kepler - Bug #4656: Build system needs javadocsResolvedChad Berkley01/08/2010

Actions
Blocks Kepler - Bug #4667: New documentation on modules and extension points for modulesIn Progressdebi staggs01/13/2010

Actions
Blocked by Kepler - Bug #4684: Release tracking bugResolvedChad Berkley01/21/2010

Actions
Blocks Kepler - Bug #4867: Update screenshots for the documentationResolveddebi staggs03/04/2010

Actions
Blocks Kepler - Bug #4868: Update R paths in documentation and demosResolvedben leinfelder03/04/2010

Actions
Actions #1

Updated by Chad Berkley over 15 years ago

I will take over as the editor of the documentation but will pass out various sections to others to author.

Actions #2

Updated by Chad Berkley over 15 years ago

I finished going through all of the documentation in kepler-docs/outreach/documentation/working. I've made changes where I could and left notes about things that need to be checked up on. Several sections need to be looked at by those in charge of specific functionality. Specifically:

Section 1: Overview - minor changes - whoever makes these changes should also make changes to the GSG
Section 2: Installing and Running Kepler - probably the most work - Chad, David
Section 3: Scientific Workflows - fact/url checking
Section 4: Working with existing workflows - fact/url checking
Section 5: Building workflows with existing actors - fact/url checking
Section 6: Working with datasets - fact/url checking
Section 7: Using remote computing resources - fact/url checking
Section 8: Mathematical, Data Analysis, and Visualization packages - Mostly fact/url checking. Section 8.2 needs Ben's attention on the R details.
Section 9: Domain Specific Workflows - need specific input from Ilkay, Chad, whoever the current GEON rep is
Section 10: Glossary - just fact check. mostly nothing to do
Section 11: Writing your own actors - needs a bit of work. needs to be changed to use the build system instead of 'javac ...' - Probably Aaron, David or Chad could do this.
Appendix B: (Where appendix A is, I do not know...) - This section needs to be gone over by Ben extensively. It is all about R and RExpression workflows.

Most of my comments are along the line of "still works?" or "check url" Most sections just need to have links checked and demo workflows checked to make sure they still work. A small number of sections need to have more extensive re-writes.

I will create a bug for each of these sections and assign it to someone. If you don't feel you're the right person to do it, let me know and we can re-assign it.

Actions #3

Updated by jianwu jianwu over 15 years ago

I will take care of <Section 7: Using remote computing resources>. One quick question: if we moved some actors (such as globus) out of Kepler 2.0 standard modules, the actors will still be introduced here and just specifying the corresponding module?

Actions #4

Updated by Chad Berkley over 15 years ago

Thanks for volunteering, Jianwu. You've asked a good question, one that I hadn't thought of. I think we just need to say in the documentation that if the user wants this functionality, he/she needs to use the module manager to download it.

Which reminds me, we need to add a new section to the UM for modules and the module manager.

Actions #5

Updated by Chad Berkley almost 15 years ago

Assigning to Debi.

Actions #6

Updated by debi staggs almost 15 years ago

All of the screenshots and hyperlinks for the getting started guide have been updated.

Actions #7

Updated by debi staggs almost 15 years ago

Chapter One of the user's guide links and screen shots have been updated. Asking Chad to review section 1.4 Future Goals to mention the status of the development of a more modular system and new methods of configuration. We also still need someone with MatLab installed to test some of the examples.

Actions #8

Updated by debi staggs almost 15 years ago

All the screen shots have been updated and links checked. So, I think everything in the documentation is ready to go except for Chapters 11 & 12, which require some input from Aaron (Ch. 11) and David Welker (Ch. 12). Thanks !

Actions #9

Updated by David Welker almost 15 years ago

The three screenshots in Chapter 12 will have to be re-done once we have published. It should only take a few minutes and I will take care of it then. =)

Actions #10

Updated by debi staggs over 14 years ago

Does everyone think we can close this bug now ?

Actions #11

Updated by David Welker over 14 years ago

There are still some screen shots needed for the module manager chapter. Perhaps a good time to do those screen shots would be right after we do a mock release right before doing a real release.

Actions #12

Updated by debi staggs over 14 years ago

Unless anyone has any objections, I am now closing this bug.

Actions #13

Updated by Redmine Admin over 11 years ago

Original Bugzilla ID was 3976

Actions

Also available in: Atom PDF