70 likes | 274 Views
EMI Documentation. Emidio Giorgio (INFN Catania) NA2 Leader 2 nd All Hands Meeting May 31th, Lünd. Overview. The Documentation review process Documentation on public web site What to improve Discussion. The Documentation Review process. Documentation Review Team (SA2/NA2).
E N D
EMI Documentation Emidio Giorgio (INFN Catania) NA2 Leader 2nd All Hands Meeting May 31th, Lünd
Overview • The Documentation review process • Documentation on public web site • What to improve • Discussion WP - Presenter Name – Event Day Month Year
The Documentation Review process Documentation Review Team (SA2/NA2) EMI web site EMI Release Tracker • Is EMI cover page used ? • How would you rate readability ? • Is present EMI funding acknowledgment ? • Is documentation updated ? • …. Is mandatory documentation provided ? NO YES WP2 – Emidio Giorgio – EMI 2nd All Hands Meeting June 1stt 2011
Issues • In some cases mandatory doc missing • Multiform documentation formats • Need of reusing existing docs • Review process started too late • documentation quality checked only on surface WP2 – Emidio Giorgio – EMI 2nd All Hands Meeting June 1stt 2011
Documentation on EMI web site • http://www.eu-emi.eu/documentation • New version here • http://www.eu-emi.eu/kebnekaise-products • Differences • Documentation is a section collecting all documentation items, categorized by type, area, format • There might be cross-product items (e.g. generic Install. Guide). • kebnekaise-products is a collection of all release products : for each of them, it’s reported all information provided by PT in release tracker WP2 – Emidio Giorgio – EMI 2nd All Hands Meeting June 1stt 2011
What to improve ? • Member of documentation review team should be informed of every documentation update • add team members to tracker items ? • Documentation review process need to start in time • 1 month before ? • Need to fix exactly acceptance criteria and actions to take when they are not matched WP2 – Emidio Giorgio – EMI 2nd All Hands Meeting June 1stt 2011
Thank you EMI is partially funded by the European Commission under Grant Agreement INFSO-RI-261611 WP - Presenter Name - EMI First EC Review 22 June 2011