Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "COSMOS Document Naming"

 
(24 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[[COSMOS|COSMOS Wiki]] > [[COSMOS_Documentation_Plan|COSMOS Document Plan]]
 
[[COSMOS|COSMOS Wiki]] > [[COSMOS_Documentation_Plan|COSMOS Document Plan]]
 +
 +
This section covers the file naming of a COSMOS documents and adding a Category documentation reference.
  
 
== Document naming ==
 
== Document naming ==
 +
 +
When creating a Wiki document page, use the following naming structure:
  
''Hi, I am open for suggestions in defining the best way to name our COSMOS documentation on our Wiki pages.''  
+
* '''wiki.eclipse.org/COSMOS_Users's_Guide_{topic}'''
''The following is an example of what I came up with, but the filename is very long. ''
+
* or '''wiki.eclipse.org/COSMOS_Development_Guide_{topic}'''
  
''Document coordinator''
+
Where '''''{topic}''''' is the name of the COSMOS component or subject. For example, the following table lists a few topics of the COSMOS User's Guide and the associated filename. 
  
''Richard Vasconi''
+
{|
''vasconi@us.ibm.com''
+
  
 +
|- border="1"
  
When creating a Wiki document page, please use the following naming structure:
+
!width="170"| Topic
 +
! Filename
  
 +
|-
 +
| align="center" | Overview
 +
| COSMOS_User's_Guide_Overview
  
 +
|-
 +
| align="center" | Management Enablement
 +
| COSMOS_User's_Guide_Management_Enablement
 +
|-
 +
| align="center" | WSDM_tooling
 +
| COSMOS_User's_Guide_WSDM_tooling
  
 +
|}
  
* '''wiki.eclipse.org/COSMOS_Document_{document}_{topic}'''
+
== Adding a Category documentation reference ==
 
+
Where '''''{document}''''' is the type of document, for example:
+
* Users_Guide
+
* Development_Guide
+
 
+
Where '''''{topic}''''' is the name of the COSMOS component or subject, for example:
+
* SML
+
* Data_Manager
+
* WSDM_tooling
+
 
+
=== Naming examples: ===
+
* COSMOS_Document_Users_Guide_WSDM_tooling
+
 
+
== Adding a Category document reference ==
+
 
To help organize and locate documents, please insert the following category tag at the bottom of your document Wiki page:
 
To help organize and locate documents, please insert the following category tag at the bottom of your document Wiki page:
  
 
<pre>'''[[Category:COSMOS Consumer Documentation]]'''</pre>
 
<pre>'''[[Category:COSMOS Consumer Documentation]]'''</pre>
  
=== Hierarchy of document categories example ===
+
=== Hierarchy of documentation categories example ===
 
<pre>
 
<pre>
 
[[Category:COSMOS]]
 
[[Category:COSMOS]]
Line 47: Line 48:
 
   
 
   
  
 
+
[[Category:COSMOS_Documentation]]
 
+
 
+
 
+
 
+
 
+
[[Category:COSMOS Documents]]
+

Latest revision as of 09:40, 12 February 2008

COSMOS Wiki > COSMOS Document Plan

This section covers the file naming of a COSMOS documents and adding a Category documentation reference.

Document naming

When creating a Wiki document page, use the following naming structure:

  • wiki.eclipse.org/COSMOS_Users's_Guide_{topic}
  • or wiki.eclipse.org/COSMOS_Development_Guide_{topic}

Where {topic} is the name of the COSMOS component or subject. For example, the following table lists a few topics of the COSMOS User's Guide and the associated filename.

Topic Filename
Overview COSMOS_User's_Guide_Overview
Management Enablement COSMOS_User's_Guide_Management_Enablement
WSDM_tooling COSMOS_User's_Guide_WSDM_tooling

Adding a Category documentation reference

To help organize and locate documents, please insert the following category tag at the bottom of your document Wiki page:

'''[[Category:COSMOS Consumer Documentation]]'''

Hierarchy of documentation categories example

[[Category:COSMOS]]
.... [[Category:COSMOS Consumer Documentation]]
............ [[Category:COSMOS User's Guide]]
............ [[Category:COSMOS Development Guide]]
To make
[[Category:COSMOS User's Guide]]
a child of
[[Category:COSMOS Consumer Documentation]]
, just edit wiki.eclipse.org/Category:COSMOS_User's_Guide and put
[[Category:COSMOS Consumer Documentation]]
at the bottom of the page, and submit the change.

Back to the top