-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Documentation: I suggest putting a strong focus on information for developers, since we need to expand this base as part of graduation. So initially tutorials are for users, documentation is for developers.
Marlon On 5/4/12 8:25 AM, Suresh Marru wrote: > > 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 -----BEGIN PGP SIGNATURE----- Version: GnuPG/MacGPG2 v2.0.16 (Darwin) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iQEcBAEBAgAGBQJPo8wGAAoJEEfVXEODPFID6/MH/RJSK46R77+tYq1qwNtZH6qx dvh6P0LGLTD3cmMGVrAvysCHIHpEzfNh5OJz9dIx6L3gB+16hMyHqn56/1ATGuXD ZpONVKxaMoMMxtGV7umaXTqdzCA9F6MzcJRe+WtaTFYsS5ropMAOXm+G/vsHd9vE dKXLNaWYV4s9XzeWPgaRZ20jpC2vpQPaNl/FAxzBSq/QiUoU76cgKepXscN0XO56 ARiEbIOv8y6hBPqUnHc6mZ4trF4xeMUNYOqyWckWAsmCuXMCZOwAOFFBpJB2M1il 2yrbQs5/DC015oCyxVMMs93SiCFAAgdK2SX1W8srd9GP1ENtj2oGEFQkcs/uVNc= =4lt4 -----END PGP SIGNATURE-----
