Documentation Validation

This page provides information about the procedure that must be followed for the validation of the documentation content and the status of this procedure . This procedure is essential for maintaining high quality documentation in the Administrator's[1], the Developer's[2] and the User's[3] guide. The actors in the procedure are the authors of each section in the aforementioned guides, and the reviewers, which are recipients of the information provided in the content for which they are responsible.

Validation Procedure

Each review process workflow consists of three stages

1. The assigned reviewer of a section must classify this section into APPROVED - MINOR CHANGES - MAJOR CHANGES, and set one of these three options into the Content Status column. This classification will give an overall estimation for the situation of the given section and will help each author understand how extensive the changes in his content should be. Reviewers should also provide more detailed comments to authors, in order to inform them about parts that have not clear meaning or must be described in more detail, parts that should be extended to broaden their scope and include more information and missing parts. During this first stage of the review process, the Initial Comments column of the Review Process Status field has yellow color (in progress). This stage finishes when the reviewer opens a ticket(Type: defect, Category (Defect): Documentation) to the author(or the responsible for the corresponding subsystem if the section is written by more than one authors), to provide him with the detailed comments of his review, and places the link for this ticket in the Related Ticket column. The reviewer changes the Initial Comments column of the Review Process Status field to green (accomplished) and the Address Comments column to yellow (in progress).
2. The author/authors of a specific section must perform the changes needed to address the initial comments of the reviewer. When this stage is completed the author changes the Address Comments column of the Review Process Status field to green (accomplished) and the Approval column to yellow (in progress).
3. The reviewer of a specific section must check that the changes performed by the author, addressed his comments. Additional comments can be provided to the author by the reviewer, through the open ticket, in order to help the author address the initial comments. When this stage is completed the reviewer must change the Approval column of the Review Process Status field to green (accomplished), place APPROVED into the Content Status column and close the open ticket.

A new review for a specific section is indicated by inserting a new line, in one of the tables below, beneath the lines that correspond to previous reviews for this section. The reason for a new review can be:

• An extended change in the contents of a section(if this change involves only a specific subsection of this section then the name of this subsection is placed into the SubSection column). In this case the new line should be inserted by the author of the section, who is also responsible for informing the corresponding reviewer about the initiation of a new review procedure for this section. The Due Date in this case must defined as five weeks after the current date.
• A major release closure. In this case the responsible for initiating the procedure is the Documentation Editor.
• Some other reason that demands validation of some parts in the three guides.

The reason must be placed into the Reason to review column. The Due Date depends on the reason for which the review is performed, and the Initial Comments should be provided to the author by the reviewer, at least 3 weeks before the Due Date. If a review process fails to be completed within the Due Date, the reviewer must place the red color (expired) to the appropriate stage in the Review Process Status field. The reviewer can change the Content Status column during the third stage of a review process(i.e. he may decide that a section that needed MAJOR CHANGES, still needs some minor changes after the second stage). If the reviewer considers a section as APPROVED after the first stage, then this review process for this section, is considered to be completed without any actions taken by the author.

Status of Validation

Developer's Guide

Section	Subsection	Author	Reviewer	Reason to review	Due Date	Content Status	Related Ticket	Review Process Status
								1	2	3
								Initial Comments	Address Comments	Approval
1. Introduction	All	Federico De Faveri, Pasquale Pagano		Major Review
2. gCube Architecture	All	Leonardo Candela, Pasquale Pagano, Manuele Simi		Major Review
3. Reference Model	All	Leonardo Candela, Paolo Roccetti, Manuele Simi		Major Review
4.1 GCube Infrastructure Enabling Services	All	Manuele Simi		Major Review
4.1.1 Information System	All	Lucio Lelii, Manuele Simi		Major Review
4.1.2 Virtual Organisation Management	All	Paolo Roccetti, Andrea Turli		Major Review
4.1.3 VRE Management	All	Lucio Lelii, Kostas Liaskos, Fabio Simeoni, Manuele Simi, Daniele Strollo		Major Review
4.1.4 Process Management	All	Paola Ranaldi		Major Review
4.1.5 Process Optimisation	All	Vassilis Verroios		Major Review
4.1.6 Execution Engine	All	Giorgos Papanikos		Major Review
4.1.7 Workflow Engine	All	Gerasimos Farantatos, Giorgos Papanikos		Major Review
4.1.8 Messaging Infrastructure	All	Andrea Manzi		Major Review
4.1.9 SAM Infrastructure	All	Andrea Manzi		Major Review
4.2 gCube Information Organisation Services (NEW)	All	Fabio Simeoni		Major Review
4.2.1 Storage Manager	All	Federico De Faveri		Major Review
4.2.2 Content Manager	All	Fabio Simeoni		Major Review
4.2.3 Content Manager Library	All	Fabio Simeoni		Major Review
4.2.4 gCube Document Model and gCube Model Library (2.0) (NEW)	All	Fabio Simeoni		Major Review
4.2.5.1 gDL 1.0	All	Federico De Faveri, Lucio Lelii		Major Review
4.2.5.2 gDL 2.0	All	Federico De Faveri, Fabio Simeoni		Major Review
4.2.6 View Manager	All	Fabio Simeoni		Major Review
4.3 gCube Information Organisation Services (LEGACY)	All	Ali Boloori		Major Review
4.3.2 Content Management	All	Diego Milano		Major Review
4.3.3 Collection Management	All	Diego Milano		Major Review
4.3.4 Metadata Management	All	Manuele Simi		Major Review
4.3.5 Annotation Management	All	Fabio Simeoni		Major Review
4.3.6 Content Import	All	Leonardo Candela, Diego Milano		Major Review
4.4 gCube Information Retrieval Services	All	Leonardo Candela		Major Review
4.4.1 gCube ResultSet (gRS)	All	Kostas Tsakalozos		Major Review
4.4.2 gCube ResultSet 2 (gRS2)	All	Gerasimos Farantatos, Giorgos Papanikos		Major Review
4.4.3 Search Framework	All	Vassilis Veroios		Major Review
4.4.4 OpenSearch Framework	All	Gerasimos Farantatos		Major Review
4.4.5 Index Management Framework	All	Vassilis Veroios		Major Review
4.4.6 Data Transformation	All	Kostas Tsakalozos		Major Review
4.4.7 Personalisation	All	Giota Koltsida		Major Review
4.4.8 Distributed Information Retrieval Support Framework	All	Fabio Simeoni		Major Review
4.4.8 gCube Ontology Management Service	All	Dimitris Katris		Major Review
4.5.1 Application Support Layer	All	Rena Tsantouli		Major Review
4.5.2 gCube Portal Engine	All	Giota Koltsida		Major Review
5.1.2. Profile Specification	All	Manuele Simi, Daniele Strollo		Major Review
5.1.3. Service Archive Specification	All	Lucio Lelii		Major Review
5.2.1. Developing gCube Portlets Guide	All	Massimiliano Assante		Major Review
5.2.2 GCube Widgets Library - General guidelines about Portlet StyleSheets	All	Massimiliano Assante		Major Review
5.2.3 GCube Portlets common icon set	All	Massimiliano Assante		Major Review
5.2.4 Inter Portlet Subscription/Notification Mechanism (Client side)	All	Massimiliano Assante		Major Review
5.2.5 Building your gCube Portlet in ETICS	All	Gabriele Giammatteo		Major Review
5.3.1. Security Model	All	Andrea Turli		Major Review
5.3.2. How To Configure Service Security	All	Andrea Turli		Major Review
5.3.3. Common Security Troubleshooting	All	Andrea Turli		Major Review
5.3.4. How to use VOMS api library	All	Andrea Turli		Major Review

User's Guide

Section	Subsection	Author	Reviewer	Reason to review	Due Date	Content Status	Related Ticket	Review Process Status
								1	2	3
								Initial Comments	Address Comments	Approval
1 Introduction	All	Leonardo Candela, Pasquale Pagano	Rena Tsantouli	Major Review	08-March-09	APPROVED
2.1 Virtual Research Environments and Community Portals	All	Leonardo Candela, Pasquale Pagano	Rena Tsantouli	Major Review	08-March-09	APPROVED
2.2 Content and Collections	All	Leonardo Candela, Pasquale Pagano	Dimitris Katris	Major Review	08-March-09	APPROVED
2.3 Content Annotation	All	Dimitris Katris	Giota Koltsida	Major Review	08-March-09	APPROVED
2.4 Metadata	All	Leonardo Candela, Pasquale Pagano	Giota Koltsida	Major Review	08-March-09	APPROVED	#1721
3.1 Workspace	All	Federico De Faveri	Rena Tsantouli	Major Review	08-March-09	APPROVED	#1735
3.2 Search	All	Valia, Giota	Massimiliano Assante	Major Review	08-March-09	APPROVED	#1700
3.3 Result Browsing	All	Massimiliano Assante	Rena Tsantouli	Major Review	08-March-09	APPROVED	#1736
3.4 Annotations	All	Dimitris Katris	Federico De Faveri	Major Review	08-March-09	APPROVED	#1711
3.5 Metadata Management	All	Dimitris Katris	Massimiliano Assante	Major Review	08-March-09	APPROVED	#1701
3.6 User Profile Management	All	Giota Koltsida	Federico De Faveri	Major Review	08-March-09	APPROVED	#1714
3.7 Report Management	All	Massimiliano Assante	Federico De Faveri	Major Review	08-March-09	APPROVED	#1717
4.1 Login to a portal instance and select a VRE	All	Giota Koltsida	Federico De Faveri	Major Review	08-March-09	APPROVED	#1715
4.2 Perform a search and view the metadata of a record	All	Giota Koltsida	Massimiliano Assante	Major Review	08-March-09	APPROVED	#1702
4.3 Change the XSLT at your profile and view the results using the new XSLT	All	Giota Koltsida	Federico De Faveri	Major Review	08-March-09	APPROVED	#1716
4.4 Annotating Information Objects	All	Dimitris Katris	Federico De Faveri	Major Review	08-March-09	APPROVED
4.5 Send a workspace area item to another user	All	Federico De Faveri	Dimitris Katris	Major Review	08-March-09	APPROVED

Administrator's Guide

Section	Subsection	Author	Reviewer	Reason to review	Due Date	Content Status	Related Ticket	Review Process Status
								1	2	3
								Initial Comments	Address Comments	Approval
1. Introduction	All	Leonardo Candela, Pasquale Pagano		Major Review
3. How to set up a gCube infrastructure	All	Manuele Simi		Major Review
4. gCube Hosting Node (gHN) Installation	All	Manuele Simi		Major Review
5. Core Services Installation	All	Manuele Simi		Major Review
5.1 Information System Installation	All	Manuele Simi		Major Review
5.2 VRE Management Services Installation	All	Manuele Simi, Daniele Strollo		Major Review
5.3 Dynamic Virtual Organization Support Service Installation	All	Paolo Roccetti		Major Review
6. How to create a Virtual Organization	All	Manuele Simi		Major Review
6.1 Installing the Virtual Organization enabling services	All	Manuele Simi		Major Review
6.2 Configuring the Virtual Organization	All	Manuele Simi		Major Review
6.3 Verifying the Virtual Organization correctness	All	Manuele Simi		Major Review
6.4 VO gCube Resources	All	Manuele Simi		Major Review
6.5 Dynamic Services Deployment and Configuration	All	Manuele Simi		Major Review
6.6 Monitoring the Virtual Organization	All	Manuele Simi		Major Review
6.7 Managing the Virtual Organization	All	Manuele Simi		Major Review
7. How to create a Virtual Research Environment	All	Leonardo Candela, Lino Pagano	Giota Koltsida	Major Review
7.1 Defining the Virtual Research Environment	All	Leonardo Candela, Lino Pagano	Giota Koltsida	Major Review	December 18	APPROVED
7.2 Approving the Virtual Research Environment	All	Leonardo Candela, Lino Pagano	Giota Koltsida	Major Review	December 18	APPROVED
7.3 Verifying the Virtual Research Environment correctness	All	Leonardo Candela, Lino Pagano	Giota Koltsida	Major Review	December 18	APPROVED
7.4 Managing the Virtual Research Environment	All	Leonardo Candela, Lino Pagano	Giota Koltsida	Major Review	December 18	APPROVED
8.1 gCube Portal Installation	All	Giota Koltsida	Tommaso Piccioli	Major Review	December 18	APPROVED
8.2 Authorization management with LDAP	All	Massimiliano Assante	Rena Tsantouli	Major Review	December 18	APPROVED
8.3 Portal Administration Functionality	All	Rena Tsantouli	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.3.1 Layout Generator	All	Rena Tsantouli	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.3.2 Roles' Management	All	Giota Koltsida	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.3.3 Users' Management	All	Giota Koltsida	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.3.4 Information Space Editor	All	Rena Tsantouli	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.3.5 Resource Management	All	Fabio Sinibaldi	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.3.6 Content Import	All	Diego Milano	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.3.7 Index Management	All	Spyros Boutsis, Kostas Tsakalozos	Leonardo Candela, Lino Pagano	Major Review	December 18	APPROVED
8.4 Monitoring System	All	Vassilis Moustakas	Massimiliano Assante	Major Review	December 18	APPROVED
11.1 Security Model	All	Paolo Roccetti	Rena Tsantouli	Major Review	December 18	APROVED
11.2 How To Configure gHN Security	All	Paolo Roccetti	Rena Tsantouli	Major Review	December 18	APPROVED
11.3 How To Configure Identities For gCube Services	All	Paolo Roccetti	Rena Tsantouli	Major Review	December 18	APPROVED