Wiki Style Guides
This wiki section is dedicated to style guides for this wiki and for this website's issues and layouts. This is useful for users who would like to participate in improving documentation, assist in development and prototyping howtos, and editors and translators alike.
Content
All typical content is placed in the :content:LANGUAGE directory (for US English, use the :content:en_us directory.) The docuwiki does not handle case well so please use lower case for all document names and references. The name should be descriptive but more importantly, you need to add your references in the 'keywords' section at the bottom of your document. To make changes to the wiki, you will need edit privileges. Please contact ClearCenter for rights to modify the wiki. Please be familiar with the standards maintained in this document.
Template Pages for Howto and Knowledgebase
Use this page to template your layout for howtos and knowledgebase articles:
This page will also contain instructions to help you craft articles.
Other Templates and style guides
Syntax Guide
The following guide will help you with the syntax of the wiki:
Structure
The site is undergoing transformation by importing legacy aspects of ClearCenter and ClearFoundation documentation. To make sure this happens well, some reorganization has occurred. The following is a list of old objects and where they can now be found (this serves as a transition sitemap):
ClearFoundation
Object | Old Path | New location | Comments |
---|---|---|---|
articles | :articles | :content:en_us | Links should include the keyword 'kb' |
developer | :developer | :content:en_us | Links should include the keyword 'dev' |
howtos | :howtos | :content:en_us | Links should include the keyword 'howto' or 'howtos' |
playground | :playground | :content:en_us | Links should include the keyword 'skunkworks' |
release_info | :release_info | :content:en_us | Links should include the keyword 'release' or 'releases' |
start | :start | :start | Stays the same |
user_guide | :user_guide | :content:en_us | Links should include the keyword 'userguide' |
web_site | :web_site | :content:en_us | Links should include the keyword 'website' |
wiki | :wiki | :content:en_us | Links should include the keyword 'wiki' |
related_events | related_events | :content:en_us | Links to other sites? Doesn't need to exist. Deleted. |
ClearCenter
Object | Old Path | New location | Comments |
---|---|---|---|
ClearOS 6 userguide | documentation:user_guide: | :content:en_us | Need keyword checking |
ClearOS.com
Group | Path | Comments |
---|---|---|
Open | :content:en_su | This folder contains all typical content. Create all content here and properly add keywords for it to index properly |
Open | :userguides:start | |
Open | :userguides:ClearOS_7.x: | ClearOS_7.x |
Open | :userguides:ClearOS_6.x: | ClearOS_6.x |
Open | :userguides:ClearOS_5.2: | ClearOS_5.2 |
Open | :userguides:ClearSDN: | Service Delivery Network - ClearCenter Portal |
Open | :userguides:Developer: | Developer Guides |
Open | :userguides:Website: | ClearOS Website and Forum Guides |
Group | Path | Comments |
Premium Content
In some cases, articles will exist behind content specific walls. Links will exist to articles in separate wikis which require authentication or specific subscriptions to access. In these cases, the articles will exist as a line in the wiki.
Making changes
To make changes to the wiki, you will need rights. You will need to request for those rights and log into ClearOS.com as the user that has wiki edit rights. From there, you will navigate to the wiki core here:
https://sfj48-fkj200.heiksthsd.cf/dokuwiki2/ doku .php? id=start
For example, you can navigate to the following URL to make a document called kb_howto_do_this_or_that:
https://sfj48-fkj200.heiksthsd.cf/dokuwiki2/ doku .php? id=content:en_us:kb_howto_do_this_or_that
From here you can simply edit the document.
Pay attention to the structure of the directory. For the most part, all articles are located in the content:en_us folder for English wiki articles. As mentioned earlier, you can use the Syntax Guide for help on formatting articles. You can use templates or other articles to help you craft your article.
For the most part, please store images in :omedia
Wiki Elements Added to System
There are some additional wiki elements from extensions and plugins.
Notes
Informational Note
Notes give information as an aside to the main topic or give emphasis to the current topic.
This is a new feature.
Important Note
Important notes give notice for recommended items. This will come from best practices or other compelling factors.
Enabling outside http access and authenticated user access on Web Flexshares without using SSL will mean that your passwords will be transmitted across the Internet in plain text!!
Tip
A tip shows the users optional information that can be particularly useful but not required. This can be a best practice or some method that is just cool.
Enabling this feature makes this usable by the Flexshare module.
Warning
Warnings are used to express concern if there are irreversible or dangerous procedures. These help the reader take special care before proceeding.
Formatting your drive during the install automatically WILL delete all information on ALL drives that are connected, not just the first one !!
Navigation
To help guide users through a specific task, you will often ask a user to click through a menus system. For example:
Network|Firewall|Port Forwarding
Buttons
To help guide users through a specific task, you will often ask a user to click on a specific button. For example:
Add the IP address and click on
Add the IP address and click on