Actions

JDOC

Difference between revisions of "Policies and guidelines"

From Joomla! Documentation

m (New page: <noinclude>{{shortcut|JDOC:PAG|JDOC:POLICY|JDOC:GUIDE}}</noinclude> Policies and guidelines express standards that have community consensus, though to differing degrees: [[Project:POLICY|p...)
 
m (new category)
(5 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
Abstracts of current key policies and guidelines are given in the next sections including links to their full text.</noinclude>
 
Abstracts of current key policies and guidelines are given in the next sections including links to their full text.</noinclude>
  
=Editorial style guides=
+
==Wiki policy==
<noinclude>{{underconstruction|section|placedby=--<span class="plainlinks">[[User:CirTap|CirTap]] <small>([[User talk:CirTap|talk]] • [[Special:Contributions/CirTap|contribs]])</small></span> 16:59, 10 May 2008 (EDT)}}</noinclude>
+
{{#section: Project:Wiki policy | introduction}}
 +
:[[Project:Wiki policy|Read the full policy]] &hellip;
 +
 
 +
==Editorial style guides==
 
The guides in this chapter should help authors and editors to preserve a consistant styling and naming of the wiki-based documentation. You can also download the general [http://help.joomla.org/workshop/documents/Editorial%20Style%20Guide%20v1.0.5.pdf Editorial Style Guide] (PDF) that applies to all Joomla! Documentation.
 
The guides in this chapter should help authors and editors to preserve a consistant styling and naming of the wiki-based documentation. You can also download the general [http://help.joomla.org/workshop/documents/Editorial%20Style%20Guide%20v1.0.5.pdf Editorial Style Guide] (PDF) that applies to all Joomla! Documentation.
==Words to watch==
+
===Words to watch===
 
{{#section: Project:Words to watch | abstract}}
 
{{#section: Project:Words to watch | abstract}}
 
:[[Project:Words to watch|Read the full guideline]] &hellip;
 
:[[Project:Words to watch|Read the full guideline]] &hellip;
 +
===Summary style===
 +
* Sections of long articles should be spun off into their own articles leaving a summary in its place
 +
* Summary sections are linked to the detailed article with a {{tl|main|&lt;name of detailed article>}} or [[Template:Otheruses templates#For (other topic)|comparable template]]
 +
* To preserve links to the edit history of the moved text, the first edit summary of the new article links back to the original: add <nowiki>"spin-off of [[Original large article]]"</nowiki> into the ''{{int:summary}}'' field.
  
=Documentation policies=
+
==Documentation policies==
==Licensing==
+
===Licensing===
 
{{license}}
 
{{license}}
 
:[[JEDL|Read the full license]] &hellip;
 
:[[JEDL|Read the full license]] &hellip;
==Structure==
+
===Structure===
 
{{notice|1=Brief list of subjects that will be covered on dedicated pages.}}
 
{{notice|1=Brief list of subjects that will be covered on dedicated pages.}}
 +
* [[Project:Image naming convention|Image naming convention]]
 
* [[Project:Category|Category]]
 
* [[Project:Category|Category]]
 
:Categories help users navigate the Joomla! Documentation via multiple [[wikipedia:Taxonomy|taxonomies]]
 
:Categories help users navigate the Joomla! Documentation via multiple [[wikipedia:Taxonomy|taxonomies]]
Line 23: Line 31:
 
* &hellip;
 
* &hellip;
  
==Hatnotes==
+
===Hatnotes===
 
{{#section-h: Project:Hatnotes }}
 
{{#section-h: Project:Hatnotes }}
 
:[[Project:Hatnotes|Read the full guideline]] &hellip;
 
:[[Project:Hatnotes|Read the full guideline]] &hellip;
  
=See also=
+
==See also==
 
*[[Project:Wiki Templates Project|Wiki Templates Project]]
 
*[[Project:Wiki Templates Project|Wiki Templates Project]]
  
 
<noinclude>
 
<noinclude>
[[Category:Style guides]]
+
[[Category:Style guides|{{PAGENAME}}]]
 +
[[Category:Documentation Wiki Policies and Guidelines|{{PAGENAME}}]]
 
</noinclude>
 
</noinclude>

Revision as of 22:14, 2 February 2013

Shortcuts:
JDOC:PAG
JDOC:POLICY
JDOC:GUIDE

Policies and guidelines express standards that have community consensus, though to differing degrees: policies are considered a standard that all users should follow, whereas guidelines are more advisory in nature. Both need to be approached with common sense. A user who acts against the spirit of them may be reprimanded, even if technically no rule has been violated. Those who edit in good faith, are civil, seek consensus, and work towards the goal of creating great documentation for the Joomla! project(s) should find a welcoming environment.

Abstracts of current key policies and guidelines are given in the next sections including links to their full text.

Contents

Wiki policy

This policy covers usage of the Joomla! Documentation Wiki at docs.joomla.org. Failure to abide by this policy may result in editing or removal of your contributions. We reserve the right to ban abusers from this site either for a specific time period or indefinitely. We reserve the right to change this policy at any time.

Read the full policy

Editorial style guides

The guides in this chapter should help authors and editors to preserve a consistant styling and naming of the wiki-based documentation. You can also download the general Editorial Style Guide (PDF) that applies to all Joomla! Documentation.

Words to watch

Words to Watch are words commonly misspelled or which may have variations that depend on the Joomla! style guide choices.

Read the full guideline

Summary style

  • Sections of long articles should be spun off into their own articles leaving a summary in its place
  • Summary sections are linked to the detailed article with a {{main}} or comparable template
  • To preserve links to the edit history of the moved text, the first edit summary of the new article links back to the original: add "spin-off of [[Original large article]]" into the Summary: field.

Documentation policies

Licensing

License

The contents of this wiki are subject to copyright law and are made available under the Joomla! Electronic Documentation License (JEDL) unless otherwise stated. You may find the JEDL Frequently Asked Questions useful in determining if your proposed use of this material is allowed. If you have any questions regarding licensing of this material please contact legal@opensourcematters.org. If you wish to report a possible violation of the license terms for the material on this site then please contact legal@opensourcematters.org.

Read the full license

Structure

Info non-talk.png
General Information

Brief list of subjects that will be covered on dedicated pages.

Categories help users navigate the Joomla! Documentation via multiple taxonomies
Categories are for defining characteristics, and should be specific, neutral, inclusive and follow certain conventions.

Hatnotes

Hatnotes are short notes placed at the top of an article before the primary topic, generally either 1) to provide disambiguation of closely related terms or 2) to summarise a topic, and explain its boundaries. "Hatnote" is also a polite term to refer to improper disambiguation links which exceed standard length, link directly to trivial topics instead of a disambiguation page.

This style guideline is intended to make this process more efficient by giving article pages a consistent look, and avoiding distracting information (such as extraneous links).

Read the full guideline

See also