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

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

B.) Contribution to the KB

1. Please LogIn by eduGAIN or Social Media (e.g. G+ or Facebook)
2. Please complete your profile - minimum: Full Name, e-mail (Profile)
3. Chose your category (e.g Network, EndHost, Performance and Measurement Tools, General Knowledge, and Case Studies) on the "Welcome Page" or look for topics by using "search field" for existing content. 
4. New Contribution:

• • Chose your topic area (e.g. Network) through categories on the "Welcome"-page or by "search field". The "parent" topics are shown (hierarchy). On your left hand side you see the Page Tree

• • Staying on your parent topic, you find on top in the menu the button "Create" (new page), on top of your new page you see the "Path*" where your new page is located in the KDB
  • In the example below your current space is "eduPERT KB" (this is the highest hierarchy) - Parent on your new page is "Contributing to the KDB". 

• • Set the title of your new page (in the example - eduPERT final Home).
  • On your new page - please make your contributions. Features available for contributions see menu list on top of your new page.
  • If you have finished your contribution you are able to have a "Preview".
  • If you want to finalise the contribution, please press "Update". 
  • 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 Workflow - Page Status and visibility see E.

C.) Review/Revise existing Content

1. On the category (e.g. Network) chose in the "PAGE TREE" the existing topic or search in the "search field" about your topic.
2. Click on the topic, click the button "edit" on top of your right and side and review/revise the page.
3. If you have finished your review/revise you are able to have a "Preview", please click on the "Preview" .
4. If you like to finalise your review/revise, please click on the botton "Update" on your right hand side. 
5. You will find your revision under your chosen hierarchy, parent page in the page tree or you can search for your review/revise in the "search field". 

      Details about Workflow - 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
3. Fill in there your comments. 
4. With the button "Save" you make immediately your comments visible (Published) - does not need an approval from the eduPERT team. 

     Details about Workflow - Page Status and visibility see E.

E.) Workflow: Page Status - Contributions / Review: 

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

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 is sent to the SMEs (to the eduPERT team) and "contributor" about the new contribution with the opportunity (View page) for Reviewing
6. One SME from the eduPERT team will Review the contribution –  approving or rejecting the contribution with comments:
   1. Contribution approved => Page Status Contribution “Published” => the contribution is now visible for the whole world:
      1. A mail is sent to the contributor, noted with the approve.
      2. Contribution rejected => Status Contribution “Editing”:
         1. A mail is sent to the contributor, noted with rejecting the contribution with Page Status “Editing".
         2. Contributor can revise/report and ask again for Reviewing => Change page status to reviewing.
         3. One SME will Review the contribution – will approve or reject the contribution with comment.

Existing Contribution revised/extended...

1. Clicking on "Edit" (on top) the Page changes automatically to the status “Editing”.
2. After revision of the page the Contributor has to change the page status Editing to  “Reviewing”.
3. A mail will be sent to the SMEs (eudPERT team).
4. The reviewer will check revisions and will approve, reject contribution
   1. If the contribution/revision is approved it will be published immediately (visible for everybody) => Page Status “Published”
   2. The contributor will be notified by email that the contribution/revision is approved and visible. 
   3. If the contribution/revision is rejected the Page Status went back to “Editing”: 
      1. A mail will be sent to the contributor to add, delete or correct the contribution (based on comments from the reviewer)
      2. After adding additional content or making corrections the contributor has to change the Page Status from “Editing” to “Review” and click Update at the foot of the page
      3. An email will be sent to the SMEs (eduPERT team) for reviewing the addition content, revision
      4. After Reviewing the contribution will be approved (visible for the public) or rejected (status page Editing).

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

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

G.) Looking for contribution ideas 

1. Go to TODO under Contributing to the KDB