On May 3, 2012, at 2:54 PM, Heshan Suriyaarachchi wrote: > I might need some time to write up some more tutorials as well. Let me know > if you have any ideas on what I should writeup or include in the > documentation.
Hi Heshan, I am not sure I have specific ideas per say, but here are some needs of tutorials/documentation: Tutorials: It could be divided into three categories: * Basic functional walkthrough - this tutorial should be as simple as possible. This tutorial should have as minimal setup as possible so the community should be encouraged to quickly run through to validate the releases and so on. * Intermediate - These tutorial(s) should also require minimal configuration, but can assume multiple steps, like first register your application, second construct a graph, third execute, fourth browse outputs and so on. These set of tutorials should give the user a decent idea about Airavata and encourage them to look further. * Advanced - These tutorials might assume pre-requisite expertise and focus on specific areas like grid job management, provenance aware workflows and so on. Documentation: I did not think much here, but at the minimum we should clearly separate out user and developer (API) documentation. We should start writing more and more of how to build over Airavata using the API docs and sandbox examples. Suresh
