EMI INFSO-RI EMI Documentation Emidio Giorgio (INFN Catania) NA2 Leader 2 nd All Hands Meeting May 31th, Lünd
EMI INFSO-RI Overview The Documentation review process Documentation on public web site What to improve Discussion WP - Presenter Name – Event Day Month Year 2
EMI INFSO-RI The Documentation Review process WP2 – Emidio Giorgio – EMI 2 nd All Hands Meeting June 1st t EMI Release Tracker Documentation Review Team (SA2/NA2) Is EMI cover page used ? How would you rate readability ? Is present EMI funding acknowledgment ? Is documentation updated ? …. Is EMI cover page used ? How would you rate readability ? Is present EMI funding acknowledgment ? Is documentation updated ? …. Is mandatory documentation provided ? EMI web site YES NO
EMI INFSO-RI 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 2 nd All Hands Meeting June 1st t
EMI INFSO-RI Documentation on EMI web site – New version here New version here 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 2 nd All Hands Meeting June 1st t
EMI INFSO-RI 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 2 nd All Hands Meeting June 1st t
EMI INFSO-RI Thank you 7 WP - Presenter Name - EMI First EC Review 22 June 2011 EMI is partially funded by the European Commission under Grant Agreement INFSO-RI