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