(r9) ProtocolHowTo < Lab

---+!! How to Create a Protocol

%TOC%

---++ Tips for Design

 You should generally organize a protocol to have sections that are relevant from this list:
   * Supplies (materials, strains, primers)
   * Step-by-step instructions for each step
   * Expected results (quantitative information, graphics, images)
   * Common problems and troubleshooting
   * Spreadsheets for calculations

Include instructions that reference specific reagents (strains, primers, etc.) for performing *positive* and *negative* control reactions. It is very important and can save a great deal of time if you run these reactions to diagnose bad reagents or a general problem with carrying out the protocol versus a problem with applying it in a specific case.

*These protocols are public, so don't post passwords, protected information, or copyrighted material. Use the [[InternalList][internal Barrick Lab web pages]] for that.*

---++ How to Create a New Protocol / Wiki Page

   1 Navigate to the page that will link to your new page.
   1 Edit this page.
      * Add a link using this syntax: <verbatim>[[TopicName][Link Text]]</verbatim>
      * =TopicName= should be a [[TWiki.WikiWord][WikiWord]] that is descriptive of the new topic. Many topics on the Barrick Lab pages begin with certain words indicating how they are categorized, e.g. "Protocol", "Reference", "Internal".
      * =Link Text= will be the text of the hyperlink that appears on the web page.
      * Save your edit.
   1 Now, a red link to your new page should appear when you view this page. 
   1 Click on the red link and you will be taken to the edit window for your new page!

---++ How to Add Images

   1 Click the "attach" link at the bottom of your page
   1 Choose your image file:
      * Avoid spaces in the file name. Use underscores instead.
      * Under "Properties" check the box called "Create a link to the attached file."
   1 After you click "Upload file" your image will appear at the bottom of the page after a bullet point.
   1 Now edit the page and move the =<img>= tag to where you want it displayed in the page.

Tips:
   * If you accidentally forget to hide the attachment, you can click on the attach link and then edit the properties of the file you uploaded at any later time. 
   * You can refer to an image that is attached to a different page with this syntax: <verbatim> <img src="%PUBURL%/%WEB%/OtherTopic/image.jpg"> </verbatim>

---++ Further Tips for Editing the Wiki

Try editing a page where you see what you want to do and copying the syntax!! Monkey see, Monkey do.

General resources
   * [[TWiki.TextFormattingRules][TextFormattingRules (Shorthand)]]
   * [[TWiki.TWikiVariables][TWiki Variables]]
   * [[TWiki.TWikiDocGraphics][TWiki Icons]]
   * [[TWiki.TWikiReferenceManual][TWiki Reference Manual]] 

Useful links for editing the Barrick Wiki (required log in)
   * [[WebAdministration][Web Administration]]
Barrick Lab > ProtocolList > ProtocolHowTo
Topic revision: r9 - 2020-12-07 - 04:19:20 - Main.JeffreyBarrick