Difference between revisions of "EclipseLink/UserGuide/Contributor Guidelines"

From Eclipsepedia

Jump to: navigation, search
m (New page: This page contains guidelines and information for EclipseLink users who would like to contribute to the EclipseLink User's Guide.)
 
m
Line 1: Line 1:
 
This page contains guidelines and information for EclipseLink users who would like to contribute to the [[EclipseLink/UserGuide|EclipseLink User's Guide]].
 
This page contains guidelines and information for EclipseLink users who would like to contribute to the [[EclipseLink/UserGuide|EclipseLink User's Guide]].
 +
 +
==General Markup and Formatting==
 +
The ''EclipseLink User's Guide'' is created with the [[Main_Page|Eclipse Wiki (Eclipsepedia)]] which uses [http://www.mediawiki.org Mediawiki]. See [http://meta.wikimedia.org/wiki/Help:Wikitext_examples Wikitext Examples] for information on using wiki markup and formatting.
 +
 +
 +
==Page Names==
 +
*Do not use "CamelCase" or "WikiWords" when creating new pages. This makes the page name difficult to read. The Eclipsepedia wiki is capable of using spaces and other punctuation in wiki page names.
 +
*Append '''(ELUG)''' to the end of each ''EclipseLink User's Guide'' page. This allows users to filter searches to include ''only'' pages from the guide.
 +
 +
 +
==Categories==
 +
Categories help users find information that pertains only to specific EclipseLink uses. We use [[:Category:EclipseLink_User%27s_Guide|these categories]]:
 +
*Architecture
 +
**JPA
 +
**ORM
 +
**EIS
 +
**XML
 +
*Status
 +
**Draft
 +
**Final
 +
*Type
 +
**Concept
 +
**Task
 +
*Version
 +
**1.0
 +
 +
 +
 +
 +
==Figures==
 +
*Include an anchor point for all figures. This allows incoming links directly to the figure. Use <tt>&lt;span id="'''XXXXX'''"></span></tt> where '''XXXXX''' is a unique identifier.
 +
*Include a title for each figure. Use '''''bold+italic''''' for the title.
 +
*When referencing (and linking to) figures, use the format:
 +
:For more information see the Foo figure.
 +
 +
 +
==Examples==
 +
*Include an anchor point for all examples. This allows incoming links directly to the example. Use <tt>&lt;span id="'''XXXXX'''"></span></tt> where '''XXXXX''' is a unique identifier.
 +
*Include a title for each figure. Use '''''bold+italic''''' for the title.
 +
*When referencing (and linking to) figures, use the format:
 +
:For more information see the Foo example.
 +
*To show multiple lines of code examples correctly, simply indent the first characters (single space) of each line. For example:
 +
example line 1
 +
example line 2
 +
example line 3
 +
*To show examples inline, in example font, use: &lt;tt>Example</tt> to produce <tt>Example</tt>.
 +
 +
 +
 +
==Tables==
 +
*Include an anchor point for all tables. This allows incoming links directly to the table. Use <tt>&lt;span id="'''XXXXX'''"></span></tt> where '''XXXXX''' is a unique identifier.
 +
*Include a title for each table, if necessary. Use '''''bold+italic''''' for the title.
 +
*When referencing (and linking to) tables, use the format:
 +
:For more information see the Foo table.
 +
 +
 +
 +
[[Category: EclipseLink User's Guide]]

Revision as of 09:56, 14 December 2007

This page contains guidelines and information for EclipseLink users who would like to contribute to the EclipseLink User's Guide.

Contents

General Markup and Formatting

The EclipseLink User's Guide is created with the Eclipse Wiki (Eclipsepedia) which uses Mediawiki. See Wikitext Examples for information on using wiki markup and formatting.


Page Names

  • Do not use "CamelCase" or "WikiWords" when creating new pages. This makes the page name difficult to read. The Eclipsepedia wiki is capable of using spaces and other punctuation in wiki page names.
  • Append (ELUG) to the end of each EclipseLink User's Guide page. This allows users to filter searches to include only pages from the guide.


Categories

Categories help users find information that pertains only to specific EclipseLink uses. We use these categories:

  • Architecture
    • JPA
    • ORM
    • EIS
    • XML
  • Status
    • Draft
    • Final
  • Type
    • Concept
    • Task
  • Version
    • 1.0



Figures

  • Include an anchor point for all figures. This allows incoming links directly to the figure. Use <span id="XXXXX"></span> where XXXXX is a unique identifier.
  • Include a title for each figure. Use bold+italic for the title.
  • When referencing (and linking to) figures, use the format:
For more information see the Foo figure.


Examples

  • Include an anchor point for all examples. This allows incoming links directly to the example. Use <span id="XXXXX"></span> where XXXXX is a unique identifier.
  • Include a title for each figure. Use bold+italic for the title.
  • When referencing (and linking to) figures, use the format:
For more information see the Foo example.
  • To show multiple lines of code examples correctly, simply indent the first characters (single space) of each line. For example:
example line 1
example line 2
example line 3
  • To show examples inline, in example font, use: <tt>Example</tt> to produce Example.


Tables

  • Include an anchor point for all tables. This allows incoming links directly to the table. Use <span id="XXXXX"></span> where XXXXX is a unique identifier.
  • Include a title for each table, if necessary. Use bold+italic for the title.
  • When referencing (and linking to) tables, use the format:
For more information see the Foo table.