M Riedel 27/01/11

Dear Kathryn, PEB,

the milestone is surely a good comprehensive collection of gathered pieces of information and I would argue to accept the milestone when the below mentioned minor comments are addressed.

Having the training courses [2] accessible on the Web-site is good, especially the 'most relevant' idea I like.

Having seen the milestones and the Websites, I have only some minor comments:

(1) Documentation EMI page [1]

Like the training courses page I would suggest to also add a few links in a category like 'most relevant below' as done for the training page.

(2) Last sentence with example:

"Some additional materials, which will complement the documentation produced by the product teams, are also currently being developed by NA2, and these are expected to be published on the website in the near future."

Please add a few examples what you mean by complementary documentation that you currently develop.

(3) Finally, as software evolves in time, it would be nice to know on which dates the pieces of information behind the links have been produced.

E.g. ARC Server Installation Instructions (month/year)

(4) And (3) leads me to the final recommendation of adding a few lines to the milestones about the approach 'how the links are regularly checked' in order to prevent a broken-link provisioning. Do we have/need such an approach for the overall Website?!

Thanks and good work!

Take care, Morris

[1] http://www.eu-emi.eu/en/us-documentation

[2] http://www.eu-emi.eu/en/us-training

Responses from Author

1. We have actually now updated both pages to remove the links to the wiki as we feel it is better to keep the internal and public pages separate. We have created an edited list of documentation on the public page instead of the link to the wiki.

2. Done.

3. This is a very good idea, but there are some practical issues with getting the correct dates, particularly where we link to a site with several resources each with different modification dates. Deeper linking to individual resources provided by external projects may be required in order to provide accurate modification times, however this would need to be agreed with the projects in question. We will investigate this, and I have indicated this in the new version of the milestone report.

4. I have included the information on how we are currently maintaining these pages, indeed we may need to look at doing something similar for the whole website if we are not already doing so.

-- FloridaEstrella - 28-Jan-2011

This topic: EMI > WebHome > EmiDocuments > EmiMilestones > MilestoneMNA231 > MNA231MRiedelReview
Topic revision: r2 - 2011-02-08 - KathrynCassidy
This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2021 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback