Difference between revisions of "Wikispooks:Document Editing Rules"

From Wikispooks
Jump to navigation Jump to search
(Complete reword)
m (Text replacement - " -- " to " — ")
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
''Pages in the '''Document''' namespace ''(i.e. with names which begin "Document:") ''are finished pieces of work and so two special rules apply.
+
{{HelpSection|image=ws_document.png}}
 +
''Pages in the '''Document''' [[Help:Namespaces|namespace]] ''(i.e. with names which begin "Document:") ''are not ongoing productions but finished pieces of work.'' Accordingly, two rules apply to the {{NS|Document}} which apply nowhere else on Wikispooks:
  
== 1. Use Template:DocProv ==
+
== 1. Use Template:Document ==
Although it is not featured in some older documents, the [[template:DocProv]] template should be used at the top of all new items in the document namespace. It provides a convenient way to list all the editable items (i.e. the metadata such as the author, source, date and so on).  
+
<span class="plainlinks">[{{fullurl:Special:AllPages|from=&to=&namespace=110}} All pages in the {{t|document:}} namespace]</span> use the [[template:Document]] template at the top. This provides a convenient way to provide metadata such as the author, source, publication date, document type and so on. Putting all the metadata in a predictable place facilitates [[Wikispooks:Semantic Mediawiki|Semantic Mediawiki]]. All this information is editable, and you are encouraged to fill out as many of the fields as you can. If the document's author is new to this website, you are recommended to help readers by making for the author, even if it has relatively little content, e.g. just a few URLs.
  
 
== 2. No Content Editing ==
 
== 2. No Content Editing ==
Unlike other namespaces, where page editing is encouraged, content of pages in the 'document:' namespace should not be changed, since they are finished pieces of work by the author(s) credited in the DocProv template. Page formatting improvements (such as wikifying links) is acceptable, as is the fixing of typos, but no other edits are acceptable; the authenticity of source documents must be preserved.
+
Unlike other namespaces, where page editing is encouraged, ''content'' of pages in the {{NS|document}} must not be changed, since they are finished pieces of work by the author(s) credited in [[template:Document]]; the authenticity of source documents must be preserved with the same attention as [[direct quotations]].  
  
* ''See the [[Help:WikiSpooksHelp|WikiSpooks Help]] page for more details of namespaces''
+
== 3. Errata ==
 +
Preserving of errors is helpful to indicate the accuracy (or otherwise) of the document. Simple typographical errors are best just left, but if the document contains unambiguously verifiable falsehoods (e.g. matters of undisputed fact rather than interpretations), best practice is to add a footnote clarifying this. e.g. "<nowiki><ref>In fact, the author was [[John Gatto]] — [http://www.unwelcomeguests.net/The_Underground_History_of_American_Education See here]</ref> — ~~~~</nowiki>", The "<nowiki>~~~~</nowiki>" characters will expand to a signature, giving the time and date of your correction.
  
[[category:Help]]
+
==Good practice==
 +
You are recommeneded to re-publish works ''in their entirety'' as a single document, even when they are serialised, unless their are special reasons for treating them separately (for example, if they have different subjects, or if their separate publication dates are important).
 +
 
 +
''In contrast to content edits, formatting improvements (especially adding internal wikilinks) ''are'' encouraged'', for example the fixing of typos. Another common adjustment to Wikispooks style is to replace use of single quotes (') with double quotes (") where they are used for direct quotations.
 +
 
 +
For discussion about a document, use its {{t|Talk}} page, If you wish to make a more formal and permanent comment about a document, the recommended way to do so is to use [[Template:Rate]].
 +
 
 +
{{Wikispooks Footer/Policy}}
 +
[[category:Wikispooks Policy]]

Latest revision as of 16:34, 10 January 2023

Ws document.png

Pages in the Document namespace (i.e. with names which begin "Document:") are not ongoing productions but finished pieces of work. Accordingly, two rules apply to the Document: namespace which apply nowhere else on Wikispooks:

1. Use Template:Document

All pages in the document: namespace use the template:Document template at the top. This provides a convenient way to provide metadata such as the author, source, publication date, document type and so on. Putting all the metadata in a predictable place facilitates Semantic Mediawiki. All this information is editable, and you are encouraged to fill out as many of the fields as you can. If the document's author is new to this website, you are recommended to help readers by making for the author, even if it has relatively little content, e.g. just a few URLs.

2. No Content Editing

Unlike other namespaces, where page editing is encouraged, content of pages in the document: namespace must not be changed, since they are finished pieces of work by the author(s) credited in template:Document; the authenticity of source documents must be preserved with the same attention as direct quotations.

3. Errata

Preserving of errors is helpful to indicate the accuracy (or otherwise) of the document. Simple typographical errors are best just left, but if the document contains unambiguously verifiable falsehoods (e.g. matters of undisputed fact rather than interpretations), best practice is to add a footnote clarifying this. e.g. "<ref>In fact, the author was [[John Gatto]] — [http://www.unwelcomeguests.net/The_Underground_History_of_American_Education See here]</ref> — ~~~~", The "~~~~" characters will expand to a signature, giving the time and date of your correction.

Good practice

You are recommeneded to re-publish works in their entirety as a single document, even when they are serialised, unless their are special reasons for treating them separately (for example, if they have different subjects, or if their separate publication dates are important).

In contrast to content edits, formatting improvements (especially adding internal wikilinks) are encouraged, for example the fixing of typos. Another common adjustment to Wikispooks style is to replace use of single quotes (') with double quotes (") where they are used for direct quotations.

For discussion about a document, use its Talk page, If you wish to make a more formal and permanent comment about a document, the recommended way to do so is to use Template:Rate.


Wikispooks logo.png Policy.png
Wikispooks
Policy
Wikispooks to do.png Tools2.png SMW.png Help.png