Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @ egi.eu.

Difference between revisions of "EGI-Engage:Quality Plan"

From EGIWiki
Jump to navigation Jump to search
 
(29 intermediate revisions by one other user not shown)
Line 3: Line 3:
{{TOC_right}}  
{{TOC_right}}  


'''Help and support:''' Malgorzata Krakowian  malgorzata.krakowian@egi.eu (Quality Manager)
'''Help and support:''' quality@egi.eu  


<br>  
<br>  


This page is providng rules regarding organization, communication and recording of work within EGI-Engage project. <br>  
This page is providng rules regarding organization, communication and recording of work within EGI-Engage project. <br>  
<br>


<br>  
<br>  
Line 19: Line 17:
The following rules must be used:  
The following rules must be used:  


== Meetings ==
*'''Meetings run by EGI-Engage''':&nbsp;'''<br>The meetings must be recorded '''in the [https://indico.egi.eu/indico/categoryDisplay.py?categId=137 EGI Indico server ]and all presentations and material provided for the meeting, including any minutes, must be attached to the appropriate agenda page.
*'''Presentations and posters''':&nbsp;'''<br>Presentations and/or posters presented at other meetings attended by EGI-Engage staff must be recorded''' in the [https://documents.egi.eu/public/DocumentDatabase EGI Document Repository] and '''[[EGI-Engage templates]]''' must be used. A link to the meeting and a summary of the outcome should be recorded in the ‘notes’ section of the document. A dedicated EGI-Engage tag is available to qualify documents, milestones, papers, presentations and other documentation relevant to the project.
*'''Mailing list: '''<br>As the majority of the communication within the project will be electronic having a coherent record of that work is essential. '''All mailing lists must use the EGI.eu based mailing lists''' which allow groups defined within the single sign on to be linked to mailing lists, access to wiki space, document access, etc. '''If needed mailing list related to EGI-engage project should start with egi-engage-'''<br>Mailing lists to be used within EGI-Engage project:<br>
**'''egi-engage-po@egi.eu''': EGI-Engage project office
**'''egi-engage-cb@mailman.egi.eu''':&nbsp;SSO based. Collaboration Board
**'''egi-engage-financial@mailman.egi.eu''':&nbsp;SSO based. For discussion of project administration and financial aspects
**'''egi-engage-pmb@mailman.egi.eu''':&nbsp;SSO based. Project Management Board (to be populated)
**'''egi-engage-amb@mailman.egi.eu''':&nbsp;SSO based. Activity Management Board members - composed of WP leaders. <br>
**'''egi-engage-members@mailman.egi.eu''':&nbsp;SSO based. Includes all members of the project including people registered to EGI-Engage-related mailing lists<br>
**'''For work packages:&nbsp;'''SSO based
***[mailto:egi-engage-wp1@mailman.egi.eu egi-engage-wp1@mailman.egi.eu]
***[mailto:egi-engage-wp2@mailman.egi.eu egi-engage-wp2@mailman.egi.eu]
***[mailto:egi-engage-wp3@mailman.egi.eu egi-engage-wp3@mailman.egi.eu]
***[mailto:egi-engage-wp4@mailman.egi.eu egi-engage-wp4@mailman.egi.eu]
***[mailto:egi-engage-wp5@mailman.egi.eu egi-engage-wp5@mailman.egi.eu]
***[mailto:egi-engage-wp6@mailman.egi.eu egi-engage-wp6@mailman.egi.eu]
**Dedicated Task mailing lists can be found on WP wiki pages - WP leader is responsible to decide how many and which one mailing lists are necessary to run efficiently the workpackage.<br>


'''The meetings must be recorded '''in the [https://indico.egi.eu/indico/categoryDisplay.py?categId=137 EGI Indico server ]and all presentations and material provided for the meeting, including any minutes, must be attached to the appropriate agenda page.  
*'''Requirement and actions gathering<br>'''Requirements and actions gathering should be performed through [http://rt.egi.eu/ EGI&nbsp;RT system]
*'''Surveys'''<br>All data deriving from surveys created and circulated by the project should be exported in (one of xls/csv/ods) format and provided to the quality manager for deposit and providing following information:<br>- WP number<br>- Title of the survey<br>- Purpose of the survey and target group, Deliverable, Milestones where outcome has been used (if applicable)<br>- Period when the survey was published and closed<br>
*'''Websites '''<br>'''www.egi.eu is the main website for the project'''. A dedicated set of project pages is being prepared. It is used mainly for all ‘official’ ‘static’ content. [http://www.egi.eu/about/egi-engage/ http://www.egi.eu/about/egi-engage/ ]<br>The wiki '''wiki.egi.eu '''should be used for all dynamic content being maintained or developed within each project activity. EGI-Engage Project main wiki page: [https://wiki.egi.eu/wiki/EGI-Engage:Main_Page https://wiki.egi.eu/wiki/EGI-Engage:Main_Page]<br> Content:
**description of the project
**work packages dedicated pages (tasks, contacts, deliverables, milestones) ''Please do not change structure of the page.''
**milestones and deliverables
**quality plan&nbsp;<br>
**metrics<br>'''Other third party websites or wikis should not be used to host EGI-Engage related material '''in order that the egi.eu domain becomes the definitive source of project information. Individual services supported by EGI.eu will have their own hostname in the egi.eu domain.


== Presentations and posters<br> ==
== Templates ==


'''Presentations and/or posters presented at other meetings attended by EGI-Engage staff must be recorded''' in the [https://documents.egi.eu/public/DocumentDatabase EGI Document Repository] and [http://www.egi.eu/about/logo_templates/ '''EGI-Engage templates'''] must be used.&nbsp;
All EGI-Engage templates can be found under [http://www.egi.eu/about/logo_templates/index.html http://www.egi.eu/about/logo_templates/index.html]  


A link to the meeting and a summary of the outcome should be recorded in the ‘notes’ section of the document.
== Acknowledgement  ==


A dedicated EGI-Engage tag is available to qualify documents, milestones, papers, presentations and other documentation relevant to the project.  
Proper [[Copyright#EGI-Engage|acknowledgement statements]] should be used for EGI-Engage outputs unless the output already uses one of the recognised project templates, where appropriate acknowledgements are already included.  


<br>  
<br>  


== Mailing lists ==
== Software and Services quality ==


As the majority of the communication within the project will be electronic having a coherent record of that work is essential.
=== Services  ===


'''All mailing lists must use the EGI.eu based mailing lists''' which allow groups defined within the single sign on to be linked to mailing lists, access to wiki space, document access, etc.  
'''Quality of services '''produced within EGI-Engage project will be ensured by the '''adoption of the EGI Services management standard FitSM''', a international standard developed by the [http://fitsm.eu FedSM project].  


Mailing lists to be used within EGI-Engage project:<br>
Instruction for Tools teams can be found under '''[[Instructions for Production Tools teams|Instructions Tools teams]]'''


*'''egi-engage-po@egi.eu''': EGI-Engage project office
<br>  
*'''egi-engage-cb@mailman.egi.eu''':&nbsp;SSO based. Collaboration Board
*'''egi-engage-financial@mailman.egi.eu''':&nbsp;SSO based. For discussion of project administration and financial aspects
*'''egi-engage-pmb@mailman.egi.eu''':&nbsp;SSO based. Project Management Board (to be populated)
*'''egi-engage-amb@mailman.egi.eu''':&nbsp;SSO based. Activity Management Board members - composed of WP leaders. <br>
*'''egi-engage-members@mailman.egi.eu''':&nbsp;SSO based. Includes all members of the project including people registered to EGI-Engage-related mailing lists<br>  


*'''For work packages:&nbsp;'''SSO based
=== Software  ===
**[mailto:egi-engage-wp1@mailman.egi.eu egi-engage-wp1@mailman.egi.eu]
**[mailto:egi-engage-wp2@mailman.egi.eu egi-engage-wp2@mailman.egi.eu]
**[mailto:egi-engage-wp3@mailman.egi.eu egi-engage-wp3@mailman.egi.eu]
**[mailto:egi-engage-wp4@mailman.egi.eu egi-engage-wp4@mailman.egi.eu]
**[mailto:egi-engage-wp5@mailman.egi.eu egi-engage-wp5@mailman.egi.eu]
**[mailto:egi-engage-wp6@mailman.egi.eu egi-engage-wp6@mailman.egi.eu]
*Dedicated Task mailing lists can be found on WP wiki pages - WP leader is responsible to decide how many and which one mailing lists are necessary to run efficiently the workpackage.


'''If needed mailing list related to EGI-engage project should start with egi-engage-'''<br>
'''The software produced''' within the project will follow the well established [[EGI Software Component Delivery|'''Software provisioning process''']] that has been adopted since 2010, based on the definition of quality criteria, quality verification and software validation in a controlled production environment of the federated EGI infrastructure.


== Requirement and actions gathering  ==
The development activities within the project will augment capabilities of existing open source software. The resulting software code, tools and interfaces developed as part of EGI-Engage will be released as open source code and the full access will be provided via publicly available source code repositories such as GitHub, SourceForge, Subversion (SVN), Concurrent Version System (CVS) etc. Software developers will be able to choose their preferred source code repository to better integrate with existing practices, nevertheless they will need to


Requirements and actions gathering should be performed through [http://rt.egi.eu/ EGI&nbsp;RT system]
*ensure that the contribution is openly accessible,
*add the metadata information needed to enable reuse,
*communicate the URL to the consortium.


== Websites ==
== Other ==


=== www.egi.eu<br>  ===
All tools availabe for EGI-Engage to be used are listed under [[EGI Collaboration tools|EGI Collaboration tools]]


'''www.egi.eu is the main website for the project'''. A dedicated set of project pages is being prepared. It is used mainly for all ‘official’ ‘static’ content. <br>  
= Document management<br> =


[http://www.egi.eu/about/egi-engage/ http://www.egi.eu/about/egi-engage/ ]
All documents, presentations and other material that form an official output of the project (not just milestones and deliverables) are placed in the document repository to provide a managed central location for all material.  


=== wiki.egi.eu<br> ===
<br>  


The wiki has group based access control provided through the EGI SSO system. This can be used for all dynamic content being maintained or developed within each project activity.
== Content  ==


EGI-Engage Project main wiki page: [https://wiki.egi.eu/wiki/EGI-Engage:Main_Page https://wiki.egi.eu/wiki/EGI-Engage:Main_Page]<br> Content:
All documents will be written in English and use document formats described in the following section. In addition to the fields and sections already described in the document template, deliverables must include an Executive Summary and, if required, one or more Annexes. References to external document and a Glossary to terms not listed on the website must be recorded. The correct capitalisation of the project name is EGI-Engage. English date format must be used (DD/MM/YYYY) when required.  


*description of the project  
<br>''All output from the project (paper or presentation) must include the phrase: EGI-Engage is co-funded by the Horizon 2020 Framework Programme&nbsp; of the European Union under grant number 654142''  
*work packages dedicated pages (tasks, contacts, deliverables, milestones) ''Please do not change structure of the page.''  
*milestones and deliverables
*quality assurance&nbsp;<br>


=== Third party websites  ===
unless the output is using one of the recognised project templates where appropriate acknowledgements are already included.


'''Other third party websites or wikis should not be used to host EGI-Engage related material '''in order that the egi.eu domain becomes the definitive source of project information. Individual services supported by EGI.eu will have their own hostname in the egi.eu domain.
== Formats and tools  ==


== Templates  ==
The following tools and formats will be recognised within the project:


All EGI-Engage templates can be found under [http://www.egi.eu/about/logo_templates/index.html http://www.egi.eu/about/logo_templates/index.html]
*Word Processing: ‘Word Format’ allowing its use on MS Office on Windows/Mac and OpenOffice on Linux
*Spreadsheet: ‘Excel Format’ allowing the use of MS Office on Windows/Mac.  
*Presentation: ‘Powerpoint Format’ allowing the use of MS Office on Windows/Mac.


== Other  ==
Final version of all formal documents (milestones and deliverables) must be available in PDF format.


All tools availabe for EGI-Engage to be used are listed under [[EGI Collaboration tools|EGI Collaboration tools]]
<br>  
 
= Document management<br> =


== Document naming convention  ==
== Document naming convention  ==
Line 116: Line 124:
|-
|-
| '''VERSION'''  
| '''VERSION'''  
| This is the version number generated by the document repository for the particular repository identifier.
| This is the version number generated by the document repository for the particular repository identifier.  
Versioning rule:
 
*+0.1 – new version of draft
*+1.0 – new version of approved document
 
|}
|}


Line 179: Line 192:
Access to internal or confidential documents is controlled at SSO group level, with SSO IDs being assigned to particular groups depending on their permissions to view or modify documents. Public documents are available to all, without restriction or the requirement to log in. Restricted documents can only be viewed and/or modified by logging in using an account with the correct permissions.  
Access to internal or confidential documents is controlled at SSO group level, with SSO IDs being assigned to particular groups depending on their permissions to view or modify documents. Public documents are available to all, without restriction or the requirement to log in. Restricted documents can only be viewed and/or modified by logging in using an account with the correct permissions.  


== Content guidelines  ==
<br>


All documents will be written in English and use document formats described in the following section. In addition to the fields and sections already described in the document template, deliverables must include an Executive Summary and, if required, one or more Annexes. References to external document and a Glossary to terms not listed on the website must be recorded. The correct capitalisation of the project name is EGI-Engage. English date format must be used (DD/MM/YYYY) when required.
<br>  
 
<br> All output from the project (paper or presentation) must include the phrase: <!--[if gte mso 9]><xml>
<o:OfficeDocumentSettings>
  <o:RelyOnVML/>
  <o:AllowPNG/>
</o:OfficeDocumentSettings>
</xml><![endif]-->
 
<!--[if gte mso 9]><xml>
<w:WordDocument>
  <w:View>Normal</w:View>
  <w:Zoom>0</w:Zoom>
  <w:TrackMoves/>
  <w:TrackFormatting/>
  <w:PunctuationKerning/>
  <w:ValidateAgainstSchemas/>
  <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
  <w:IgnoreMixedContent>false</w:IgnoreMixedContent>
  <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
  <w:DoNotPromoteQF/>
  <w:LidThemeOther>EN-GB</w:LidThemeOther>
  <w:LidThemeAsian>X-NONE</w:LidThemeAsian>
  <w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript>
  <w:Compatibility>
  <w:BreakWrappedTables/>
  <w:SnapToGridInCell/>
  <w:WrapTextWithPunct/>
  <w:UseAsianBreakRules/>
  <w:DontGrowAutofit/>
  <w:SplitPgBreakAndParaMark/>
  <w:EnableOpenTypeKerning/>
  <w:DontFlipMirrorIndents/>
  <w:OverrideTableStyleHps/>
  </w:Compatibility>
  <m:mathPr>
  <m:mathFont m:val="Cambria Math"/>
  <m:brkBin m:val="before"/>
  <m:brkBinSub m:val="&#45;-"/>
  <m:smallFrac m:val="off"/>
  <m:dispDef/>
  <m:lMargin m:val="0"/>
  <m:rMargin m:val="0"/>
  <m:defJc m:val="centerGroup"/>
  <m:wrapIndent m:val="1440"/>
  <m:intLim m:val="subSup"/>
  <m:naryLim m:val="undOvr"/>
  </m:mathPr></w:WordDocument>
</xml><![endif]--><!--[if gte mso 9]><xml>
<w:LatentStyles DefLockedState="false" DefUnhideWhenUsed="true"
  DefSemiHidden="true" DefQFormat="false" DefPriority="99"
  LatentStyleCount="267">
  <w:LsdException Locked="false" Priority="0" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Normal"/>
  <w:LsdException Locked="false" Priority="9" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="heading 1"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 2"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 3"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 4"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 5"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 6"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 7"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 8"/>
  <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 9"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 1"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 2"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 3"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 4"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 5"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 6"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 7"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 8"/>
  <w:LsdException Locked="false" Priority="39" Name="toc 9"/>
  <w:LsdException Locked="false" Priority="35" QFormat="true" Name="caption"/>
  <w:LsdException Locked="false" Priority="10" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Title"/>
  <w:LsdException Locked="false" Priority="1" Name="Default Paragraph Font"/>
  <w:LsdException Locked="false" Priority="11" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Subtitle"/>
  <w:LsdException Locked="false" Priority="22" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Strong"/>
  <w:LsdException Locked="false" Priority="20" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Emphasis"/>
  <w:LsdException Locked="false" Priority="59" SemiHidden="false"
  UnhideWhenUsed="false" Name="Table Grid"/>
  <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Placeholder Text"/>
  <w:LsdException Locked="false" Priority="1" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="No Spacing"/>
  <w:LsdException Locked="false" Priority="60" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Shading"/>
  <w:LsdException Locked="false" Priority="61" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light List"/>
  <w:LsdException Locked="false" Priority="62" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Grid"/>
  <w:LsdException Locked="false" Priority="63" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 1"/>
  <w:LsdException Locked="false" Priority="64" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 2"/>
  <w:LsdException Locked="false" Priority="65" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 1"/>
  <w:LsdException Locked="false" Priority="66" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 2"/>
  <w:LsdException Locked="false" Priority="67" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 1"/>
  <w:LsdException Locked="false" Priority="68" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 2"/>
  <w:LsdException Locked="false" Priority="69" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 3"/>
  <w:LsdException Locked="false" Priority="70" SemiHidden="false"
  UnhideWhenUsed="false" Name="Dark List"/>
  <w:LsdException Locked="false" Priority="71" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Shading"/>
  <w:LsdException Locked="false" Priority="72" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful List"/>
  <w:LsdException Locked="false" Priority="73" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Grid"/>
  <w:LsdException Locked="false" Priority="60" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Shading Accent 1"/>
  <w:LsdException Locked="false" Priority="61" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light List Accent 1"/>
  <w:LsdException Locked="false" Priority="62" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Grid Accent 1"/>
  <w:LsdException Locked="false" Priority="63" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 1 Accent 1"/>
  <w:LsdException Locked="false" Priority="64" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 2 Accent 1"/>
  <w:LsdException Locked="false" Priority="65" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 1 Accent 1"/>
  <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Revision"/>
  <w:LsdException Locked="false" Priority="34" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="List Paragraph"/>
  <w:LsdException Locked="false" Priority="29" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Quote"/>
  <w:LsdException Locked="false" Priority="30" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Intense Quote"/>
  <w:LsdException Locked="false" Priority="66" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 2 Accent 1"/>
  <w:LsdException Locked="false" Priority="67" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 1 Accent 1"/>
  <w:LsdException Locked="false" Priority="68" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 2 Accent 1"/>
  <w:LsdException Locked="false" Priority="69" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 3 Accent 1"/>
  <w:LsdException Locked="false" Priority="70" SemiHidden="false"
  UnhideWhenUsed="false" Name="Dark List Accent 1"/>
  <w:LsdException Locked="false" Priority="71" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Shading Accent 1"/>
  <w:LsdException Locked="false" Priority="72" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful List Accent 1"/>
  <w:LsdException Locked="false" Priority="73" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Grid Accent 1"/>
  <w:LsdException Locked="false" Priority="60" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Shading Accent 2"/>
  <w:LsdException Locked="false" Priority="61" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light List Accent 2"/>
  <w:LsdException Locked="false" Priority="62" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Grid Accent 2"/>
  <w:LsdException Locked="false" Priority="63" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 1 Accent 2"/>
  <w:LsdException Locked="false" Priority="64" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 2 Accent 2"/>
  <w:LsdException Locked="false" Priority="65" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 1 Accent 2"/>
  <w:LsdException Locked="false" Priority="66" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 2 Accent 2"/>
  <w:LsdException Locked="false" Priority="67" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 1 Accent 2"/>
  <w:LsdException Locked="false" Priority="68" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 2 Accent 2"/>
  <w:LsdException Locked="false" Priority="69" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 3 Accent 2"/>
  <w:LsdException Locked="false" Priority="70" SemiHidden="false"
  UnhideWhenUsed="false" Name="Dark List Accent 2"/>
  <w:LsdException Locked="false" Priority="71" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Shading Accent 2"/>
  <w:LsdException Locked="false" Priority="72" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful List Accent 2"/>
  <w:LsdException Locked="false" Priority="73" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Grid Accent 2"/>
  <w:LsdException Locked="false" Priority="60" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Shading Accent 3"/>
  <w:LsdException Locked="false" Priority="61" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light List Accent 3"/>
  <w:LsdException Locked="false" Priority="62" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Grid Accent 3"/>
  <w:LsdException Locked="false" Priority="63" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 1 Accent 3"/>
  <w:LsdException Locked="false" Priority="64" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 2 Accent 3"/>
  <w:LsdException Locked="false" Priority="65" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 1 Accent 3"/>
  <w:LsdException Locked="false" Priority="66" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 2 Accent 3"/>
  <w:LsdException Locked="false" Priority="67" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 1 Accent 3"/>
  <w:LsdException Locked="false" Priority="68" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 2 Accent 3"/>
  <w:LsdException Locked="false" Priority="69" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 3 Accent 3"/>
  <w:LsdException Locked="false" Priority="70" SemiHidden="false"
  UnhideWhenUsed="false" Name="Dark List Accent 3"/>
  <w:LsdException Locked="false" Priority="71" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Shading Accent 3"/>
  <w:LsdException Locked="false" Priority="72" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful List Accent 3"/>
  <w:LsdException Locked="false" Priority="73" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Grid Accent 3"/>
  <w:LsdException Locked="false" Priority="60" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Shading Accent 4"/>
  <w:LsdException Locked="false" Priority="61" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light List Accent 4"/>
  <w:LsdException Locked="false" Priority="62" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Grid Accent 4"/>
  <w:LsdException Locked="false" Priority="63" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 1 Accent 4"/>
  <w:LsdException Locked="false" Priority="64" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 2 Accent 4"/>
  <w:LsdException Locked="false" Priority="65" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 1 Accent 4"/>
  <w:LsdException Locked="false" Priority="66" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 2 Accent 4"/>
  <w:LsdException Locked="false" Priority="67" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 1 Accent 4"/>
  <w:LsdException Locked="false" Priority="68" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 2 Accent 4"/>
  <w:LsdException Locked="false" Priority="69" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 3 Accent 4"/>
  <w:LsdException Locked="false" Priority="70" SemiHidden="false"
  UnhideWhenUsed="false" Name="Dark List Accent 4"/>
  <w:LsdException Locked="false" Priority="71" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Shading Accent 4"/>
  <w:LsdException Locked="false" Priority="72" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful List Accent 4"/>
  <w:LsdException Locked="false" Priority="73" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Grid Accent 4"/>
  <w:LsdException Locked="false" Priority="60" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Shading Accent 5"/>
  <w:LsdException Locked="false" Priority="61" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light List Accent 5"/>
  <w:LsdException Locked="false" Priority="62" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Grid Accent 5"/>
  <w:LsdException Locked="false" Priority="63" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 1 Accent 5"/>
  <w:LsdException Locked="false" Priority="64" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 2 Accent 5"/>
  <w:LsdException Locked="false" Priority="65" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 1 Accent 5"/>
  <w:LsdException Locked="false" Priority="66" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 2 Accent 5"/>
  <w:LsdException Locked="false" Priority="67" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 1 Accent 5"/>
  <w:LsdException Locked="false" Priority="68" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 2 Accent 5"/>
  <w:LsdException Locked="false" Priority="69" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 3 Accent 5"/>
  <w:LsdException Locked="false" Priority="70" SemiHidden="false"
  UnhideWhenUsed="false" Name="Dark List Accent 5"/>
  <w:LsdException Locked="false" Priority="71" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Shading Accent 5"/>
  <w:LsdException Locked="false" Priority="72" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful List Accent 5"/>
  <w:LsdException Locked="false" Priority="73" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Grid Accent 5"/>
  <w:LsdException Locked="false" Priority="60" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Shading Accent 6"/>
  <w:LsdException Locked="false" Priority="61" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light List Accent 6"/>
  <w:LsdException Locked="false" Priority="62" SemiHidden="false"
  UnhideWhenUsed="false" Name="Light Grid Accent 6"/>
  <w:LsdException Locked="false" Priority="63" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 1 Accent 6"/>
  <w:LsdException Locked="false" Priority="64" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Shading 2 Accent 6"/>
  <w:LsdException Locked="false" Priority="65" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 1 Accent 6"/>
  <w:LsdException Locked="false" Priority="66" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium List 2 Accent 6"/>
  <w:LsdException Locked="false" Priority="67" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 1 Accent 6"/>
  <w:LsdException Locked="false" Priority="68" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 2 Accent 6"/>
  <w:LsdException Locked="false" Priority="69" SemiHidden="false"
  UnhideWhenUsed="false" Name="Medium Grid 3 Accent 6"/>
  <w:LsdException Locked="false" Priority="70" SemiHidden="false"
  UnhideWhenUsed="false" Name="Dark List Accent 6"/>
  <w:LsdException Locked="false" Priority="71" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Shading Accent 6"/>
  <w:LsdException Locked="false" Priority="72" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful List Accent 6"/>
  <w:LsdException Locked="false" Priority="73" SemiHidden="false"
  UnhideWhenUsed="false" Name="Colorful Grid Accent 6"/>
  <w:LsdException Locked="false" Priority="19" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Subtle Emphasis"/>
  <w:LsdException Locked="false" Priority="21" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Intense Emphasis"/>
  <w:LsdException Locked="false" Priority="31" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Subtle Reference"/>
  <w:LsdException Locked="false" Priority="32" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Intense Reference"/>
  <w:LsdException Locked="false" Priority="33" SemiHidden="false"
  UnhideWhenUsed="false" QFormat="true" Name="Book Title"/>
  <w:LsdException Locked="false" Priority="37" Name="Bibliography"/>
  <w:LsdException Locked="false" Priority="39" QFormat="true" Name="TOC Heading"/>
</w:LatentStyles>
</xml><![endif]--><!--[if gte mso 10]>
<style>
/* Style Definitions */
table.MsoNormalTable
{mso-style-name:"Table Normal";
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-noshow:yes;
mso-style-priority:99;
mso-style-parent:"";
mso-padding-alt:0cm 5.4pt 0cm 5.4pt;
mso-para-margin-top:0cm;
mso-para-margin-right:0cm;
mso-para-margin-bottom:10.0pt;
mso-para-margin-left:0cm;
line-height:115%;
mso-pagination:widow-orphan;
font-size:11.0pt;
font-family:"Calibri","sans-serif";
mso-ascii-font-family:Calibri;
mso-ascii-theme-font:minor-latin;
mso-hansi-font-family:Calibri;
mso-hansi-theme-font:minor-latin;
mso-fareast-language:EN-US;}
</style>
<![endif]-->''<span>EGI-Engage is co-funded by the Horizon 2020 Framework Programme&nbsp; of the European Union under grant number 654142</span>''
 
unless the output is using one of the recognised project templates where appropriate acknowledgements are already included.
 
== Formats and tools  ==
 
The following tools and formats will be recognised within the project:
 
*Word Processing: ‘Word Format’ allowing its use on MS Office on Windows/Mac and OpenOffice on Linux
*Spreadsheet: ‘Excel Format’ allowing the use of MS Office on Windows/Mac.
*Presentation: ‘Powerpoint Format’ allowing the use of MS Office on Windows/Mac.
 
Final version of all formal documents (milestones and deliverables) must be available in PDF format.


== Glossary  ==
== Glossary  ==


*[http://www.egi.eu/results/glossary/ Glossary]
*[http://www.egi.eu/results/glossary/ Glossary]
== Copyright  ==
See [[Copyright|Copyrights wiki page]]


= Review process for deliverables and milestones  =
= Review process for deliverables and milestones  =


All deliverables and milestones should be a subject of review. Depending of the type of milestone and deliverable different inputs to the process are required.<br>  
All deliverables and milestones should be a subject of review defined under [https://wiki.egi.eu/wiki/PROC01_Deliverables_and_milestones_review https://wiki.egi.eu/wiki/PROC01_Deliverables_and_milestones_review]<br>


Types:<br>
== Guidelines for editors  ==


*'''R:''' Document, report<br>
While creating Deliverable and Milestones Editor should remember to:  
*'''DEM:''' Demonstrators, pilots, prototypes, plan design <br>
*'''DEC:'''&nbsp;Website, press &amp; media actions, events<br>
*'''OTHER:''' software, technical diagram etc. <br>


<br>
*Language set in the document should be English (U.K)
*Use change tracking
*Mandatory field (Executive summary, Introduction)
*Once document reach review step use always last version from Document DB
*References preferably in the footer as footnote


Input to review process depending on the type:<br>
= QA internal resources  =


*'''R:''' full report<br>
*[[EGI-Engage:QA Project set up]] Set up for EGI Engage project in terms of supporting tools
*'''DEM:''' Delivery of the product, short 1-4 page report
*'''DEC:'''&nbsp;Delivery of the product, short 1-4 page report; Events: delivery, satisfaction survey, short 1-4 page report
*'''OTHER:''' software, technical diagram etc. <br>
**'''software non user facing:''' delivery, UMD acceptance criteria process, short 1-4 report based on stage rollout process outcome
**'''software user facing:'''&nbsp;delivery, satisfaction survey, short 1-4 page report
**'''other''':&nbsp;short 1-4 page report
 
<br> Classification to the one of above category will be a subject of discussion during AMB meetings.


<br>  
<br>  
== Roles<br>  ==
'''Reviewer''': Responsible for providing a review of the document on the EGI review form so that responses from the document authors to the reviewer can be tracked. A change tracked version of the document can be provided with corrections for spelling, formatting and other minor issues. '''The reviewer is generally from the activity and organisation that is not responsible for producing the document.'''
'''Moderator''': Responsible for deciding in cases of conflicting reviews, which elements of a review must be implemented by the author. The decision to follow or reject a reviewer’s comment must be tracked in the review document. '''The moderator is normally an EGI-Engage taskleader not from the activity producing the document.''' Moderator is also reviewer.
'''Editor''': The person from the activity and the partner who is responsible for the document. They may rely on others within the activity to provide the information. '''The editor cannot be a moderator or reviewer.'''
'''Quality Manager (QM)''': The project office provides administrative support for the process.<br>
'''Shepherd''': The shepherd is a member of the AMB who is responsible for overseeing the production of the document. They will work with the Editor to ensure that the work is done in a timely manner, and report to the AMB on its progress. '''Normally the activity manager or their deputy.'''
'''AMB Chair''': This is Technical Director, or their deputy.
[NOTE: an individual could hold one or more of these roles if they are not in conflict with each other.]
== Review Process  ==
The review process is identical for milestones and deliverables except for:
*Milestones are expected to have '''2 reviews''' – from the moderator and reviewer - 1 external, 1 AMB member.
*Deliverables are expected to have '''3 reviews''' – from two reviewers and the moderator - 1 external, 1 PMB member, 1 AMB member.
The reviewers are drawn (one from each of EGI’s functional areas not involved in its production) from EGI’s functional areas (i.e. Operations, User Community, Technology and Policy).<br>
'''Process (short version):'''
*7 weeks ahead – ToC
*5 weeks ahead – Draft Complete
*START: 4 weeks ahead - END: 2 weeks ahead – Start Review
*2 weeks ahead – At AMB
*1 week ahead – At PMB
*at EC
'''Process (full version):'''
{| border="1"
|-
| '''Time before submission'''
| '''Person'''
| '''Action'''
| '''RT Action'''
|-
| &gt;2 months<br>
| QM <br>
| Assign ticket in EGI&nbsp;RT&nbsp;to WP leader responsible for the document<br>
| Assigned to WP leader <br>
|-
| 2 months
| Shepherd
| Assign Editor<br>
| Remains blank with CC&nbsp;to editor<br>
|-
| 7 weeks
| Shepherd
|
Ensure
*the editor has provided the table of contents (optionally including notes as to the contents of each section)
*ToC has been circulated through AMS&nbsp;mailing list for comments
*the document is stored in DoCDB
| Set state to ToC
|-
| 6 weeks
| Shepherd
| Shepherd is aware a draft <br>
*is available in the repository
*is under active development with revisions from the contributors
| Set state to Draft
|-
| 5 weeks
| Shepherd
|
The draft
*is stable
*is undergoing review within the activity
*is nearly complete
| Set state to Internal Review
|-
| 4 weeks
| Shepherd
| The document is ready for external review.
|
Set state to External Review
|-
| Immediately
| Shepherd
|
Shepherd
*notifies reviewer(s), moderator and AMB that the document is available for review
*confirm expected review completion date with reviewers
Please use
*[https://documents.egi.eu/document/2469 EGI-Engage Deliverable and Milestone review form]
| Enter completion date as Due Date in RT
|-
| Immediately
| Shepherd
| Notify the Editor that review is complete
| Set state to Being Revised
|-
| Immediately
| Editor
| Notify the Shepherd an updated document is available
| Set state to External Review
|-
| Immediately
| Shepherd
|
The external review is complete.
Notify the AMB that the document has completed external review
| Set state to AMB Review <br>
|-
| 1 week
| AMB Chair
| The PMB is emailed that the document is available for the PMB to review for 1 week
| Set state to PMB Review
|-
| Deadline
| <br>
| A clean PDF version of the document is generated by the QM and placed in the document repository with updated meta-data
| Set state to With EC
|}
<br>
= QA internal resources  =
*[[EGI-Engage:QA Project set up]] Set up for EGI Engage project in terms of supporting tools


[[Category:EGI-Engage]]
[[Category:EGI-Engage]]

Latest revision as of 09:02, 16 September 2016

EGI-Engage project: Main page WP1(NA1) WP3(JRA1) WP5(SA1) PMB Deliverables and Milestones Quality Plan Risk Plan Data Plan
Roles and
responsibilities
WP2(NA2) WP4(JRA2) WP6(SA2) AMB Software and services Metrics Project Office Procedures



Help and support: quality@egi.eu


This page is providng rules regarding organization, communication and recording of work within EGI-Engage project.


Project communication and outputs

All output produced by staff active within EGI-Engage (funded and unfunded effort) must be recorded so that it can be reported by the project.

The following rules must be used:

  • Meetings run by EGI-Engage
    The meetings must be recorded
    in the EGI Indico server and all presentations and material provided for the meeting, including any minutes, must be attached to the appropriate agenda page.
  • Presentations and posters
    Presentations and/or posters presented at other meetings attended by EGI-Engage staff must be recorded
    in the EGI Document Repository and EGI-Engage templates must be used. A link to the meeting and a summary of the outcome should be recorded in the ‘notes’ section of the document. A dedicated EGI-Engage tag is available to qualify documents, milestones, papers, presentations and other documentation relevant to the project.
  • Mailing list:
    As the majority of the communication within the project will be electronic having a coherent record of that work is essential. All mailing lists must use the EGI.eu based mailing lists which allow groups defined within the single sign on to be linked to mailing lists, access to wiki space, document access, etc. If needed mailing list related to EGI-engage project should start with egi-engage-
    Mailing lists to be used within EGI-Engage project:
    • egi-engage-po@egi.eu: EGI-Engage project office
    • egi-engage-cb@mailman.egi.eu: SSO based. Collaboration Board
    • egi-engage-financial@mailman.egi.eu: SSO based. For discussion of project administration and financial aspects
    • egi-engage-pmb@mailman.egi.eu: SSO based. Project Management Board (to be populated)
    • egi-engage-amb@mailman.egi.eu: SSO based. Activity Management Board members - composed of WP leaders.
    • egi-engage-members@mailman.egi.eu: SSO based. Includes all members of the project including people registered to EGI-Engage-related mailing lists
    • For work packages: SSO based
    • Dedicated Task mailing lists can be found on WP wiki pages - WP leader is responsible to decide how many and which one mailing lists are necessary to run efficiently the workpackage.
  • Requirement and actions gathering
    Requirements and actions gathering should be performed through EGI RT system
  • Surveys
    All data deriving from surveys created and circulated by the project should be exported in (one of xls/csv/ods) format and provided to the quality manager for deposit and providing following information:
    - WP number
    - Title of the survey
    - Purpose of the survey and target group, Deliverable, Milestones where outcome has been used (if applicable)
    - Period when the survey was published and closed
  • Websites
    www.egi.eu is the main website for the project. A dedicated set of project pages is being prepared. It is used mainly for all ‘official’ ‘static’ content. http://www.egi.eu/about/egi-engage/
    The wiki wiki.egi.eu should be used for all dynamic content being maintained or developed within each project activity. EGI-Engage Project main wiki page: https://wiki.egi.eu/wiki/EGI-Engage:Main_Page
    Content:
    • description of the project
    • work packages dedicated pages (tasks, contacts, deliverables, milestones) Please do not change structure of the page.
    • milestones and deliverables
    • quality plan 
    • metrics
      Other third party websites or wikis should not be used to host EGI-Engage related material in order that the egi.eu domain becomes the definitive source of project information. Individual services supported by EGI.eu will have their own hostname in the egi.eu domain.

Templates

All EGI-Engage templates can be found under http://www.egi.eu/about/logo_templates/index.html

Acknowledgement

Proper acknowledgement statements should be used for EGI-Engage outputs unless the output already uses one of the recognised project templates, where appropriate acknowledgements are already included.


Software and Services quality

Services

Quality of services produced within EGI-Engage project will be ensured by the adoption of the EGI Services management standard FitSM, a international standard developed by the FedSM project.

Instruction for Tools teams can be found under Instructions Tools teams


Software

The software produced within the project will follow the well established Software provisioning process that has been adopted since 2010, based on the definition of quality criteria, quality verification and software validation in a controlled production environment of the federated EGI infrastructure.

The development activities within the project will augment capabilities of existing open source software. The resulting software code, tools and interfaces developed as part of EGI-Engage will be released as open source code and the full access will be provided via publicly available source code repositories such as GitHub, SourceForge, Subversion (SVN), Concurrent Version System (CVS) etc. Software developers will be able to choose their preferred source code repository to better integrate with existing practices, nevertheless they will need to

  • ensure that the contribution is openly accessible,
  • add the metadata information needed to enable reuse,
  • communicate the URL to the consortium.

Other

All tools availabe for EGI-Engage to be used are listed under EGI Collaboration tools

Document management

All documents, presentations and other material that form an official output of the project (not just milestones and deliverables) are placed in the document repository to provide a managed central location for all material.


Content

All documents will be written in English and use document formats described in the following section. In addition to the fields and sections already described in the document template, deliverables must include an Executive Summary and, if required, one or more Annexes. References to external document and a Glossary to terms not listed on the website must be recorded. The correct capitalisation of the project name is EGI-Engage. English date format must be used (DD/MM/YYYY) when required.


All output from the project (paper or presentation) must include the phrase: EGI-Engage is co-funded by the Horizon 2020 Framework Programme  of the European Union under grant number 654142

unless the output is using one of the recognised project templates where appropriate acknowledgements are already included.

Formats and tools

The following tools and formats will be recognised within the project:

  • Word Processing: ‘Word Format’ allowing its use on MS Office on Windows/Mac and OpenOffice on Linux
  • Spreadsheet: ‘Excel Format’ allowing the use of MS Office on Windows/Mac.
  • Presentation: ‘Powerpoint Format’ allowing the use of MS Office on Windows/Mac.

Final version of all formal documents (milestones and deliverables) must be available in PDF format.


Document naming convention

  • Filenames

Filenames must use the following format in order to link any item back to other versions placed in the document repository. The filename format is:

EGI-Engage-<DOCUMENT IDENTIFIER>-V<VERSION>

DOCUMENT IDENTIFIER The document identifier is dependent on the document type. If the document is:
  • Deliverable: Use the deliverable name: e.g. D1.1, D5.5, etc.
  • Milestone: Use the milestone name: e.g. M1.2, M5.4, etc.
  • Activity: Use the activity code: e.g. SA1, NA3, etc.
  • Committee/Board: Use an acronym based on the committee or board name: e.g. TCB, OMB, UCB, SPG, etc.
  • Other: If the source of the material cannot be identified then ignore this section.
VERSION This is the version number generated by the document repository for the particular repository identifier.

Versioning rule:

  • +0.1 – new version of draft
  • +1.0 – new version of approved document


Example: EGI-Engage-M3.1-V1.0.pdf


  • Document titles

The title of documents uploaded to document repository must be in the following format:

<DOCUMENT IDENTIFIER> Title (from the first page of the document)

Example: M3.1 User Support Contacts


Metadata management

Document metadata 

The first page of the document (along with the header and footer) contains metadata that needs to be reviewed and completed:

  • Title: This must be the title of the milestone or deliverable as described in the Description of Work.
  • Deliverable/Milestone code: e.g. D1.1 or M1.1. Delete if not required.
  • Document identifier: With a correctly formulated filename (see ‘Naming Convention’) this field can be updated in MS Word by highlighting, right clicking and selecting ‘Update Field’.
  • Date: This field records the last date the document was saved and can be updated in MS Word by highlighting, right clicking and selecting ‘Update Field’.
  • Activity: Enter the work package name (WP1, WP2, etc.) that is producing this document.
  • Lead Partner: Enter the recognised shortname within the EGI-Engage project of the lead partner.
  • Document Status: This will move through the following states for milestones and deliverables:
    • TOC (Table of Contents)
    • Draft
    • Review
    • AMB/PMB Review
    • Final
  • Document Link: The URL in the EGI document repository that provides access to the document.
  • Abstract: An abstract describing the document’s contents and main conclusions. On submission of the final version this should be entered into the relevant field in the repository metadata.

The document title must be repeated into the header and before submitting a new version to the document repository the date and filename fields in the header must be updated.

Repository metadata

When creating the entry in the document repository there are a number of compulsory metadata fields that need to be completed. These should be copied from the document metadata where duplicated:

  • Title
  • Abstract
  • Keywords
  • Notes and changes
  • Media type
  • Submitter: Select the person submitting the document.
  • Authors: Select the people involved in writing significant portions of the document.
  • View: Select the groups able to view the document. Documents that are drafts may be restricted to the groups within the project that are working on the document. Documents that are complete must be marked public unless they are marked for distribution just inside the project.
  • Modify: The ‘office’ group must me marked as able to modify the document.
  • Topics: Select the topics relevant for the material. These will generally include ‘EGI-Engage’, committee/board that the material is coming from
    • Any inout from EGI-Engage would minimally have the topics ‘EGI-Engage’
    • There are also documents that are generated within the community that go beyond the scope of just the EGI-Engage project (e.g. operational policy documents) would minimally have the topics from ‘EGI’ category selected.

Access to documents

Access to internal or confidential documents is controlled at SSO group level, with SSO IDs being assigned to particular groups depending on their permissions to view or modify documents. Public documents are available to all, without restriction or the requirement to log in. Restricted documents can only be viewed and/or modified by logging in using an account with the correct permissions.



Glossary

Review process for deliverables and milestones

All deliverables and milestones should be a subject of review defined under https://wiki.egi.eu/wiki/PROC01_Deliverables_and_milestones_review

Guidelines for editors

While creating Deliverable and Milestones Editor should remember to:

  • Language set in the document should be English (U.K)
  • Use change tracking
  • Mandatory field (Executive summary, Introduction)
  • Once document reach review step use always last version from Document DB
  • References preferably in the footer as footnote

QA internal resources