Here we describe the procedure - How to contribute to the GEANT Knowledge Data Base

A.) The eduPERT KDB is read only if you have NOT authN/Z through LogIn.

B.) New Contribution to the KDB

1. Successful LogIn by eduGAIN or Social Media (G+ or Facebook)
2. Please complete your profile - minimum: Full Name, e-mail
3. Chose your category (e.g Network, EndHost, Performance and Measurement Tools, General Knowledge, and Case Studies) you like to contribute or looking for topics by "search field" about existing content. 
4. New Contribution:
   1. Chose your topic area trough categories
   2. In the Page Tree or by search field you will find the parent topic (e.g. Network), click e.g. Network and then "Create" (new page), on top of this page you find the "Location" of your new page
      1. Set the title of your new page
      2. Go to the icon "Location" and define the dependencies "Parent page - Child page(your new page)"
         1. New Space is everytime "eduPERT KB". 
         2. New Parent space is chosen category, but you can start typing a page title to see a list of suggestions (e.g. Network).
         3. Click Move
      3. On your new page - please make your contributions. Features available for contributions see menu list on top.
      4. If you have finished your contribution you are able to have a "Preview".
      5. If you like to finalise the contribution, please press "Update". 
      6. You will find the new content under chosen parent page (category) in the page tree or you can search for your new content in the "search field".

Details about Page Status and visibility see E.)

C.) Review/Revise existing Content

1. Chose your topic through categories
2. On the category (e.g. Network) chose in the "PAGE TREE" the existing topic
   1. Click on the topic and review/revise the page
   2. If you have finished your review/revise you are able to have a "Preview".
   3. If you like to finalise your review/revise, please press "Update". 
   4. You will find the review/revise under chosen parent page in the page tree or you can search for your review/revise in the "search field". 

Details about Page Status and visibility see E.)

D.) Existing or new Comment

1. Chose your topic trough categories or through the "search field" on top. 
2. At each page on the bottom you have a comment field
   1. Fill in there your text
      1. You have a preview available
      2. If you like to finalise your comments please save
      3. The comments are directly visible - can be edited, and deleted 

Details about Comment Status and visibility see E.)

Here we describe the Page status: 

E.) Workflow Contributions / Review: 

Under eduGAIN, social media (G+ and Facebook) credentials:

1. New Contribution
   1. Page Status New Page is DRAFT
   2. Page Status Editing: Create (single “empty” page) a new page under chosen parent topic
   3. Page Status Editing: Contribution activated (Update ). This contribution is not visible by the public.
   4. Contributor changes the status “Editing” to “Review” with Comment - Check status with “View Workflow” or show “Activity Report”
   5. A mail was sent to the SMEs (to the eduPERT team) about the new contribution with the opportunity (View page) for Reviewing

                        One SME from the eduPERT team will Review the contribution – will approve or reject the contribution with comments:

1. 1. 1. Contribution approved => Status Contribution “Published” => the contribution is now visible for the whole world.
         1. A mail was sent to the contributor, noted with the approve.
      2. Contribution rejected => Status Contribution “Editing”
         1. A mail was sent to the contributor, noted with reject the contribution with Page Status “Editing"
         2. Contributor can ask again for Reviewing => Page Status Reviewing
         3. One SME will Review the contribution – will approve or reject the contribution with comment.
            
            
2. Existing Contribution commented

1. 1. Clicking on the "Comment" the Page is changing automatically to the status “Editing”.
   2. The Contributor has to ask for  “Reviewing”.
   3. A mail will be sent to the SMEs (eudPERT team).
   4. The reviewer will check comments and will approve, reject comments
      1. If the comments are approved they will be published immediately (visible for everybody) => Page Status “Published”
      2. If the comments will be rejected the Page Status went back to “Editing”
         1. A mail will be sent to the contributor to add, delete or correct the contribution
         2. After add addition content, correction the contributor has to change the Page Status from “Editing” to “Review”
         3. A mail will be sent to the SMEs (eduPERT team)
         4. After Reviewing the comments the approve the comment will be visible by the public.

E.) History - On "Pages" you have your history visibly. 

1. Go to "Pages"
   1. You find "Recently Updates" and the "TREE Browser"

F.) Looking for contribution ideas 

1. Go to TODO under Contributing to the KDB

<...is work in progress... > ....the Workflow PlugIns effect has to be described here too.