====== Editing Guide ======

We may use this space to document process decisions or simply track style-guide decisions.

<WRAP left round important 50%>

===== For Discussion =====

  * Is there a usefulness and desire to create a more regular structure of "sub-sections" to our wiki entries? 
    * See Sherwood's example as a possibile guide [[omnipoetics:law_of_the_rights_of_mother_earth|Law of the Rights of Mother]]
    * Template from example above [[entry-template]]
  * Should we rename and/or reclassify entries so that information and "commentary" (essay-like) entries are distinguished? Option (flat the section of an entry that is more interpretive as "commentary"


You can make other suggestions here or in the "Discussion" are at the bottom of the page. 
</WRAP>

===== Entry Editing Process =====

  - Begin by discussing and making desired edits to entry structure
    - Pay attention to headings and subheadings
    - Use the edit guide below
    - Name a "subsection" if there are more than two paragraphs on the sub-topic. 
  - Work on cross-references (using tags but also links to other entries of relevance
  - Update or complete list of Works Cited and/or Additional References
  - Copy edit for clarity, grammar, puncuation, and consistency.
===== I. Review Tags =====

We may decide to generate a controlled vocabulary **content tags** that would serve to create cross references or links to other pages in the wiki.  Consider what might be [[useful-tags]] for the pages you have recently worked on. 



===== II. Apply Standard Heading and Structural Formatting =====

==== Basic Formatting =====

**1. At the top of each page, give the title a heading level of one**

<code>====== Title of Page ======</code>


**2. Use succinct level 2 headlines to categorize major sections.**
exs. 

<code>==== Context =====</code>

<code>==== Language =====</code> 

<code>==== Genre ====</code>

===== Bullets and Numbered Lists ===== 

Succint points can be in lists when it helps clarity 
  * 


**3. Endnotes for quoted/paraphrased sources - Additional References Listed at bottom **

Include links when possible. Include the most complete publication information available, for sources referenced and quoted. 

This code
<code>
((Rothenberg, Symposium of the Whole, 246))
</code>

will embed a link to the full information and list it at the bottom of the page.((Rothenberg, Symposium of the Whole, 246))


<WRAP center round help 60%>
Distinguish sources that are referenced and listed at the end as "Works Cited." 

"Additional References" should come at the end, listing a source not referenced.
</WRAP>



===== III. Images =====

  - When using images, please look for Public Domain or Creative Commons available documents. 
  - Upload only images less than 500K; smaller is preferable.  Resize your found image if necessary.
  - Use the "Caption" element to provide a descriptive name for accessibility; add brief source information; see below. 


<code>
{{robert_johnson.png?250|Robert Johnson - Fair Use from https://en.wikipedia.org/wiki/File:Robert_Johnson.png}}
</code>

{{ :omnipoetics:robert_johnson.png?direct&200 |Robert Johnson - Fair Use from https://en.wikipedia.org/wiki/File:Robert_Johnson.png}}


=


===== IV. Quotations - Block quote =====

Long quotes and poem quotes can be visually flagged with special markup. 

Here is a block quote: 
<blockquote>
This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.
</blockquote>

Here is a few lines from a poem within a block quote: 

<blockquote>

<poem>
This is a line
from a poem

and it respects
the line breaks

when you    put in the 
special
tags

like
so
</poem>
</blockquote>

<code>

<blockquote>

<poem>

Text Here
</poem>
</blockquote>


</code>



====== Fancy Format - Boxes and Borders ======

Let's generally omit fancy formating.  [[fancy format boxes and borders]]

-----