Logo for University of Iowa Health Care This logo represents the University of Iowa Health Care
Meet the Iowa Otolaryngology Research Scholar FellowClick Here

Editing the Iowa Protocols

last modified on: Fri, 06/24/2022 - 08:38

see also: Iowa Otolaryngology Resident Handbook

password protection: Panopto Video Embed Instructions

LOGGING IN:

  • The link for editor log-in is at the very bottom of the page. 


CREATING A NEW PAGE:

  • For most instances we use the "Basic Page" format

  • For new pages choosing an appropriate title is important. To optimize search engine results it should be simple and straightforward but also specific so you catch the hits that you want. For instance, a protocol created for the purpose of Dr. Smith’s clinic was titled “UIHC hearing loss clinic” because search engine results were less important for the focus of providing our residents information. Another page below was titled “Speech in Background Music” which will likely garner a much higher hit rate.
  • Before creating a page, check for redundancy. For example, you don’t want to create a page on “Audiograms” that has the same information of an already available page for “How to read an Audiogram”.

I like to stay with the default "rich-text"

 


FORMATTING:

  • The easiest way to format your page is to mirror the format of a similar protocol. The standard operative protocols using numbered lists:

  • Bulleted lists:

  • The Music and Hearing Loss Pages:


LINKS:

  • In general, the protocols work as a wiki (similar to Wikipedia) where the initial generated search gets you to a page but links are placed throughout the text to allow readers to continue to related topics. Often, it helps to have a group of links under the initial title.

  • To create an internal link, you highlight the intended link text. Hit the “link” icon.  For link type choose “internal path”. Then begin typing the name of the Iowa Protocols article (each article is saved as a “node”) I have sometimes found link issues if the title to a page has changed but this can be trouble-shot.

  • To create and external link, you highlight the intended link text. Hit the “link” icon.  For the link type choose URL and type the link as indicated.


IMPORTING FROM WORD:

  • Many people constuct their protocols in Microsoft Word and try to copy them into the body of the page. This usually results in formating issues. There is an icon that allows for correct copying of Microsoft Word formating. 


ADDING IMAGES:

  • Images can be added in multiple ways in the editing page, all with variable results. 

1. Adding the image through the "Image" section results in the image posting in its full form at the top of the page.

2. Adding the image through the "Gallery" section results in a display demonstrated below.

3. Adding the image through the image icon.


EDITING:

  • This follows the same basic principles. Once logged in you can go to any page and see Edit as a possible option.


CITATIONS:

  • One of the most important part of creating a protocol is making sure that there are no plagiarism or copyright concerns. If you go through a Wikipedia article every statement is meticulously cited. As you are creating a protocol the level of necessary citation depends on the type of content created. Think how you would cite in a medical journal. If it is a description of our OR procedure or needed supplies then direct citations are likely less necessary. Throughout the protocols people have used citations in a variety of ways. The priority is:

1) Absouletely get the citations on the protocols in some form.

2) Do not number the citations, or use numbers during in-text citations, as continued updates with additional references create burdensome editing issues. Instead, in-text citations can use the author name and year (Hoffman 2020)

3) Alphabetize references

4) Format references consistently. AMA format generally works well. Working through PubMed is an easy way for consistent citations:

  • In a less ideal manner some contributors have used a general list of references without in-text citations:

  • Sometimes there is an additional “Suggested Reading” portion. If you used direct quotes there should definitely be a in text citation.
  • The Music and Hearing pages uses a separate page linked on their main page to display citations:

 


IMAGE COPYRIGHT:

  • We need to avoid the use of charts, graphs and figures in articles or other sources unless specifically given permission. Providing a link to a webpage displaying a video is better than say a direct link to a video source.
  • Not all images freely available on the internet are freely available for us to publish. To post an image we need to have permission from the owner of the copyright or access to a creative commons license. If there is a photo of a patient, written consent needs to be obtained (this can be in the form of the UIHC media consent) and present in the patient chart. A creative commons license is a version of copyright where creators specify how they want their images used. They can allow or disallow commercial use, alterations, need to give credit, etc. An example shown below: