Difference between revisions of "Wiki standards"

From New_Message_from_God_Wiki
Jump to navigation Jump to search
Line 1: Line 1:
−
Here are the basic standards for posting and editing in the wiki. Discussion and questions are in the [[Talk:Wiki standards|discussion]] page.
+
Here are the basic standards for posting and editing in the wiki. Discussion and questions are in the discussion page.
  
−
==Capitalization, punctuation and square brackets==
+
;Minimize creative editing, seeking best alignment with New Message with least editorializing.
−
Punctuation and capitalization should be edited as needed for clarity, so long as it does not corrupt the meaning of message.
 
−
There is no need to put [S]quare brackets on a capitalization, nor for ellipses to prematurely end a sentence....
 
−
However, please do use ellipses to remove segments from the middle of a quote. eg. "God has" ... "spoken again."
 
  
−
::Ellipses (…) will only be used outside of quotation marks, to shorten quotations relevant to a wiki page topic. Quotation marks will enclose a passage from the original Revelation in its complete wording.
+
:::'''Headers''', a necessary exception
−
::Brackets ( [ ] )within quotation marks will only be the Messenger’s brackets, his clarification of the Revelation itself. Any wiki clarification will be outside of quotation marks, and will not use brackets.
+
::::Feel free to use your own words as placeholders when creating headers. All headers are subject to review for replacement with words found in the quotes or elsewhere in New Message
 +
::::Feel free to make headers more "new message-y" as you see fit
 +
;Excerpt quotes precisely and aptly
  
−
Use sentence case for Step/chapter titles from ''Steps to Knowledge'' and ''Greater Community Spirituality'', following NKL usage as found in books and on website. I.e., capitalize only first word and proper nouns (and words pertaining to the Divine only when pertaining strictly to the Divine, e.g., Knowledge vs. knowledge).
+
:::Copy any complete thought from the New Message word for word, with freedom to edit capitalization or punctuation to isolate the concept.
 +
:::Always check the context of your quote and ask: what is this section about? Is it about the keyword of my wiki page here? If the quote is really about another subject, put it on that page and put a "see also" (x-ref) to that page.
  
−
If you remember, please use sentence case for wiki page titles! It will facilitate interior links if we capitalize only the words normally capitalized in the New Message. This ideal is only a goal and is not consistently maintained; this is not a problem. Headers can follow the same style, though they often do not and can stand uncorrected; consistency on any given page is desirable though not essential.
+
==Brackets ( [ ] )==
 +
:::No use of brackets except as found on texts edited by Marshall. All brackets will have editor's note <nowiki><!--visible only in edit mode--></nowiki>by all brackets that have been checked against Marshall's final manuscript edit (as found on the newmessage.org website).
 +
:::A work-around when one word or so will summarize the essence of a paragraph:
 +
::::Introduce a quote with a leading topic outside of the quotation marks. Example:
 +
;Knowledge
  
 +
::::"is the core strength that you have, the core integrity, the core certainty, the core power. It is the source of the enduring love within you."
 +
==Format--capitalization, punctuation--and style choices==
 +
;Minimize ellipses.
 +
 +
::::No need to lead off the sentence with ellipsis marks ("dot-dot-dot"--" ...") to show words are missing; just capitalize the beginning of the edited sentence.
 +
::::No need to put [S]quare brackets on a capitalization, nor for ellipses to prematurely end a sentence....
 +
::::Keep the ellipsis outside the quotes by marking each solid quote, e.g.: "God has" ... "spoken again."
 +
:::Rule: Quotation marks will enclose a passage from the original revelation in its complete wording.
 +
;Sentence case
 +
 +
::Use sentence case for titles of wiki page. I.e., capitalize only if if the word is capitalized in the New Message.
 +
::So, according to use of sentence case, capitalize only proper nouns in wiki page titles. Result: a slight more ease for later embedding interior links to the page. This recommendation is OPTIONAL, as the tendency to capitalize is strong (evidently!).
 +
::Also, sentence case for sentences in titles
 +
:::::Step titles from ''Steps to Knowledge'' and
 +
:::::Chapters from ''Greater Community Spirituality''
 
==Media Files==
 
==Media Files==
−
Images should be no larger than 160px x 280px or so.
+
;Images should be no larger than 160px x 280px or so.
−
Images only, no text.
+
 
−
An unresolved software issue prevents resizing after posting; it's being investigated.  
+
::An unresolved software issue prevents resizing after posting.
−
+
::O.k. to delete images that are oversized, especially if way oversized.
 +
;No photoquotes
 +
 
 +
::Images only, no text.
 +
::O.k. to remove extant photoquotes
 
==New pages==
 
==New pages==
−
Every page should be a topic, a subject, referred to in the New Message. The clearer and more direct, the better.  
+
Every page should be a topic, a subject, referred to in the New Message. The clearer and more direct, the better. There are a few exceptions: the feeds page, and this one, for example.
−
There are a few exceptions: the [[Topic RSS Feeds|feeds]] page, and this one, for example.
 
−
 
 
 
==Original writing==
 
==Original writing==
−
Please avoid all original writing for now. However, members of the Society will be writing summaries or blurbs on some pages, so please do not delete those.
+
Avoid all original writing (in headers only as necessary), though members of the Society will be writing summaries or blurbs on some pages--please do not delete those. These words by The Society will appear at the top of a page with no quotation marks. O.k. to add format their words in italics or bold for emphasis.
−
 
 
−
==Focus==
 
−
 
 
−
A keyword search can result in finds that aren't strictly pertinent. Before copying any quotation with the relevant keyword, check the context and ask: what is this paragraph about? Is that word or phrase incidental to the context of the paragraph? At worst, a truncated quotation might misrepresent the intention of the paragraph, something to be avoided certainly.  
 
  
 
==Optimal page layout==
 
==Optimal page layout==
−
 
+
The following sequence could work as a guide: [https://www.newmessage.org/wiki/Editing_the_wiki#Sections_for_a_Page Sections for a page]. The wiki page should lead with the most direct statement on the topic, sometimes written by Society member (and italicized to emphasize their authorship), or most succinct and memorable quotes on a topic, proceeding to specific and detailed perspectives. Pages overloaded with extensive detail can calve off new pages.
−
The following sequence could work as a guide:
 
−
[[Editing the wiki#Sections for a Page|Sections for a page]]
 
  
 
==Quotes & Quotation Marks==
 
==Quotes & Quotation Marks==
 +
:All quotations should be as brief as possible: 2 paragraphs max.
 +
:Longer than one paragraph? Put in <nowiki><blockquote></blockquote></nowiki> to preserve breaks between verses.
 +
:Each different quotation from the same teaching gets their own open/close quotation marks.
 +
:All direct quotes should be wrapped in quotation marks.
 +
:All quotations should be cited:
 +
::As chapters from books of ''The One Book''
 +
:::*include book title, chapter number and chapter name if published as a printed book in a volume of ''The One Book''
 +
:::*include the title and date of the revelation if not published in a book
 +
::Add links wherever you can to the teaching on newmessage.org, stepstoknowledge.org, alliesofhumanity.org, greatwavesofchange.org
 +
'''The quotation and the citation (the name of the source revelation) are the only essential elements!''' For your convenience, the reference can simply be indicated below the quotation with indentation, using four colons. For example:
  
−
*All quotations should be as brief as possible: two paragraphs maximum. If a quotation is more than one paragraph long, merge the paragraphs into one.
+
::::The New God (January 5, 2025)
  
−
*All direct quotes should be wrapped in quotation marks, to differentiate them from paraphrases or summaries. [However, please separate different quotations from the same chapter or teaching with close quotation marks.]
+
==Ref tags==
 +
Ref tags can always be added later, using this format:
  
−
*All quotations should be cited: if it's from a book, then please include book title, chapter number and chapter name. If it's from an individual Revelation, please include the title and date of the Revelation.
+
<nowiki><ref>The New God (January 5, 2025)</ref></nowiki>
  
−
*Best practice is use of ref tags (not required), like so:
+
which winds up looking like this
−
 
+
:::<ref>The New God (January 5, 2025)</ref>
−
:<nowiki><ref>The New God (January 5, 2025)</ref></nowiki>
 
−
 
 
−
"Which winds up looking like this"<ref>The New God (January 5, 2025)</ref>
 
 
<references/>
 
<references/>
  
Line 54: Line 77:
  
 
<references/></nowiki>
 
<references/></nowiki>
−
 
−
However, the quotation and the citation (the name of the source revelation) are the only essential elements! For your convenience and to enable a fulsome wiki, the reference can simply be indicated below the quotation with indentation, using four colons. For example:
 
−
::::<nowiki>::::The New God (January 5, 2025)</nowiki>
 
−
Ref tags can always be added later.
 

Revision as of 15:24, 16 April 2020

Here are the basic standards for posting and editing in the wiki. Discussion and questions are in the discussion page.

Minimize creative editing, seeking best alignment with New Message with least editorializing.
Headers, a necessary exception
Feel free to use your own words as placeholders when creating headers. All headers are subject to review for replacement with words found in the quotes or elsewhere in New Message
Feel free to make headers more "new message-y" as you see fit
Excerpt quotes precisely and aptly
Copy any complete thought from the New Message word for word, with freedom to edit capitalization or punctuation to isolate the concept.
Always check the context of your quote and ask: what is this section about? Is it about the keyword of my wiki page here? If the quote is really about another subject, put it on that page and put a "see also" (x-ref) to that page.

Brackets ( [ ] )

No use of brackets except as found on texts edited by Marshall. All brackets will have editor's note <!--visible only in edit mode-->by all brackets that have been checked against Marshall's final manuscript edit (as found on the newmessage.org website).
A work-around when one word or so will summarize the essence of a paragraph:
Introduce a quote with a leading topic outside of the quotation marks. Example:
Knowledge
"is the core strength that you have, the core integrity, the core certainty, the core power. It is the source of the enduring love within you."

Format--capitalization, punctuation--and style choices

Minimize ellipses.
No need to lead off the sentence with ellipsis marks ("dot-dot-dot"--" ...") to show words are missing; just capitalize the beginning of the edited sentence.
No need to put [S]quare brackets on a capitalization, nor for ellipses to prematurely end a sentence....
Keep the ellipsis outside the quotes by marking each solid quote, e.g.: "God has" ... "spoken again."
Rule: Quotation marks will enclose a passage from the original revelation in its complete wording.
Sentence case
Use sentence case for titles of wiki page. I.e., capitalize only if if the word is capitalized in the New Message.
So, according to use of sentence case, capitalize only proper nouns in wiki page titles. Result: a slight more ease for later embedding interior links to the page. This recommendation is OPTIONAL, as the tendency to capitalize is strong (evidently!).
Also, sentence case for sentences in titles
Step titles from Steps to Knowledge and
Chapters from Greater Community Spirituality

Media Files

Images should be no larger than 160px x 280px or so.
An unresolved software issue prevents resizing after posting.
O.k. to delete images that are oversized, especially if way oversized.
No photoquotes
Images only, no text.
O.k. to remove extant photoquotes

New pages

Every page should be a topic, a subject, referred to in the New Message. The clearer and more direct, the better. There are a few exceptions: the feeds page, and this one, for example.

Original writing

Avoid all original writing (in headers only as necessary), though members of the Society will be writing summaries or blurbs on some pages--please do not delete those. These words by The Society will appear at the top of a page with no quotation marks. O.k. to add format their words in italics or bold for emphasis.

Optimal page layout

The following sequence could work as a guide: Sections for a page. The wiki page should lead with the most direct statement on the topic, sometimes written by Society member (and italicized to emphasize their authorship), or most succinct and memorable quotes on a topic, proceeding to specific and detailed perspectives. Pages overloaded with extensive detail can calve off new pages.

Quotes & Quotation Marks

All quotations should be as brief as possible: 2 paragraphs max.
Longer than one paragraph? Put in <blockquote></blockquote> to preserve breaks between verses.
Each different quotation from the same teaching gets their own open/close quotation marks.
All direct quotes should be wrapped in quotation marks.
All quotations should be cited:
As chapters from books of The One Book
  • include book title, chapter number and chapter name if published as a printed book in a volume of The One Book
  • include the title and date of the revelation if not published in a book
Add links wherever you can to the teaching on newmessage.org, stepstoknowledge.org, alliesofhumanity.org, greatwavesofchange.org

The quotation and the citation (the name of the source revelation) are the only essential elements! For your convenience, the reference can simply be indicated below the quotation with indentation, using four colons. For example:

The New God (January 5, 2025)

Ref tags

Ref tags can always be added later, using this format:

<ref>The New God (January 5, 2025)</ref>

which winds up looking like this

[1]
  1. ↑ The New God (January 5, 2025)
  • All pages with ref tags need this header with the single entry added below:

==References== <references/>

Retrieved from "http://www.wiki.newmessage.org/mediawiki/en/w/index.php?title=Wiki_standards&oldid=10735"