EMI INFSORI261611 EMI Documentation Emidio Giorgio INFN Catania
- Slides: 7
EMI INFSO-RI-261611 EMI Documentation Emidio Giorgio (INFN Catania) NA 2 Leader 2 nd All Hands Meeting May 31 th, Lünd
Overview The Documentation review process Documentation on public web site What to improve Discussion EMI INFSO-RI-261611 • • WP - Presenter Name – Event Day Month Year 2
The Documentation Review process Documentation Review Team (SA 2/NA 2) EMI web site EMI INFSO-RI-261611 EMI Release Tracker NO Is mandatory documentation provided ? YES • Is EMI cover page used ? • How would you rate readability ? • Is present EMI funding acknowledgment ? • Is documentation updated ? • …. WP 2 – Emidio Giorgio – EMI 2 nd All Hands Meeting June 1 st t 2011 3
Issues • In some cases mandatory doc missing • Multiform documentation formats – Need of reusing existing docs • Review process started too late EMI INFSO-RI-261611 – documentation quality checked only on surface WP 2 – Emidio Giorgio – EMI 2 nd All Hands Meeting June 1 st t 2011 4
Documentation on EMI web site • http: //www. eu-emi. eu/documentation – New version here EMI INFSO-RI-261611 • 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 WP 2 – Emidio Giorgio – EMI 2 nd All Hands Meeting June 1 st t 2011 5
What to improve ? • Member of documentation review team should be informed of every documentation update – add team members to tracker items ? EMI INFSO-RI-261611 • 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 WP 2 – Emidio Giorgio – EMI 2 nd All Hands Meeting June 1 st t 2011 6
EMI INFSO-RI-261611 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 7