How to contribute?

 

 Essentials

A predefined structure is made available to guide you to contributing content to Respipedia. Each section of the structure/article can be edited or created separately.

1- You need first to login with your myERS login details. Then click on "Topics" from the top menu bar.

2- Select a topic from the list of available topics

  • Click on the editbutton: this will display the pre-defined structure of the article with its related sections.
  • Topic is greyed: No content available yet
  • Topic is clickable: some content is available 
  • You can add a comment on the topic.

 Contribute content

When you click on the edit button to edit or create content, you will be directed to the structure of the article. This structure contains the main sections of the article. For example, the pre-defined structure for disease-based topics is displayed as follows:

Summary 

1. Epidemiology
2. Aetiology
3. Prognosis
4. Diagnosis - How is the diagnosis made?
    4.1 History, signs and symptoms
    4.2 Physical examination findings
    4.3 Differential diagnosis
    4.4 Work-up
5. Risk stratification
6. Management
7. Prevention

  • The "Summary" is to bring any highlights and  key points regarding the topic. 
  • The remaining sections should be considered as a guide for content contribution
  • Authors can edit any of the sections separately
  • Authors can add a section by clicking on "add section" or a subsection by clicking on the "+" button related to each section
  • Authors can use the buttons up and down to move their sections
  • The predefined sections cannot be deleted by the authors (content has to be inserted under the available sections)

Procedure:

  1. Select your section to be edited and click on the edit button to start
  2. Declare any conflict of interest relating to the topic and agree to the "Terms of use"  before going further
  3. Insert keywords
  4. Click on edit to start
  5. Save and publish

Important: You will have 2 hours (120 minutes) to complete your contribution. Please note that the "save and publish button" will make your article immediately available online. 

Talk: Use the "discuss" tool to post a comment or communicate with your peers regarding the topic.

Edit existing content

Editing existing content follows the same principle. When an article is published it is ready to be edited again.

You may find some sections to complete within a published Respipedia article. You may also add or change content or insert additional information, images and so on.

If you are a returning editor, the conflict of interest data you entered before will be displayed by default. Please check it and update it if necessary.

 Collaborate with peers

Collaboration is the core component of  a wiki!

  • Co-authoring: articles are devided into sections which make it easy for a group of authors to work on the same article at the same time. 
  • "Discuss" feature is made available for you to post your thoughts and communicate with peers on the topic you are building together.

 How to use the Editor:

A simple editor is made available for you to easily edit text and also to assist you structuring your edits. As indicated , the structure of the article is displayed with the related sections to be completed or edited.

Formats:

Formats are accessible from the top menu of the Editor. These are the type of formats to be used:

  • Normal text format:Click on  this icon clear format to clear formatting and use normal text
  • "Image align left"and "Image align right":To align your image left or right.

Inserting images:

  • "Insert image": from the very top of the editor. In the same window, you can
    • Align image left or right
    • Add caption to the image

Inserting Links: whether external or internal (from an article to another)

  • link by clicking on  this icon on the top of the Editor or by right clicking on your mouse

Inserting a table:

  • table You can insert a simple pre-formatted table from the top menu or by right clicking on your mouse.
  •  bullet-points Bullet points and ordered lists can also be inserted

Citing and referencing in Respipedia:

  • cite button to be used to insert in-text citations. The citations are ordered starting from number 1 and automatically inserted as footnotes at the end of the document
  • Four options are available from the Cite button: external reference, ERS reference and linking to an existing reference previously inserted in the document. See figure below.

       Select type citation

  •  Cite external: a template is provided in order to fill in the details of the reference:

      cite external

 Please fill in as much details as possible.You can search for the link to the article if the access is free on the internet and insert it in the related field. Click on Create Citation when you complete filling in details.

  • Cite Internal:You can reference any ERS publications, guidelines or resources from ERS Events (Congress, course, conference or seminars), as follows:
  1. Go to the ERS e-learning resources, do a search by keywords and locate your material to be referenced in Respipedia.

    LR cite in respipedia
  2. Click on the "Cite in Respipedia" button as indicated by the red arrow above 
  3. A window pops-up, copy the link provided in the window
    copy link
  4. Come back to Respipedia and click on "Cite" and choose "Cite from ERS"
  5. Paste the link you copied in the related field and click on "Create citation" as shown below:
    paste ERS url
  • Cite from Pubmed: just insert the PMID and create citation
    pubmed
  • Link to existing citation button allows you to link to previous citation without recreating the same citation.
  • Edit citation button makes it possible to make changes to the inserted citations.