VEX Robotics Wiki

Covering VEX IQ, VEX EDR, and VEX Pro

User Tools

Site Tools

You are here: Welcome
start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
start [2017/05/21 19:39]
pruckelshaus [Main Sections] 		start [2019/05/14 13:45] (current)
pruckelshaus [Contact Wiki Manager]
Line 1: Line 1:
-====== Introduction ======+====== Welcome ======
  
  
Line 10: Line 10:
   - [[Robot Design:Start|Robot Design]]   - [[Robot Design:Start|Robot Design]]
   - [[Education Resources:Start|Education Resources]]   - [[Education Resources:Start|Education Resources]]
 +  - [[Programming:Start|Programming]]
   - [[Software:Start|Software]]   - [[Software:Start|Software]]
   - [[Online Resources:Start|Online Resources]]   - [[Online Resources:Start|Online Resources]]
Line 17: Line 18:
  
 ---- ----
-===== Content Style Guide =====+===== Marking Pages That Need content ===== 
 + 
 +The first heading on the page for pages that don't have any content yet will have parentheses around the text so that they stand out in the navigation.  If you edit one of these pages and add content, please remove the parentheses around the first header. 
 + 
 + 
 +---- 
 +====== Branding Style Guide ====== 
 + 
 +VEX is a brand, and the reason why this wiki exists.  Please ensure that you use proper spelling and capitalization with all VEX products and concepts. 
 + 
 +The VEX Style Guide can be found [[https://www.vexrobotics.com/vexedr/support/marketing-assets|here]] and the REC Foundation Style Guide can be found [[http://www.roboticseducation.org/documents/2017/05/rec-foundation-style-guide.pdf|here]].  Consult either source if in doubt. 
 +====== Content Style Guide ======
 **Please read if you wish to contribute content to this wiki!** **Please read if you wish to contribute content to this wiki!**
  
 +In order to create or edit content in this wiki, you must first create an account.  Click on "Log In" at the top of the page, and then "register" to create an account.
  
 +===== Pages =====
 +To create a new page, you must first create a link to that page (even though it doesn't exist).  See the "Links" and "Information Design" sections below.  Once you click on that link, you will see a "This topic does not exist yet"page.  Click on the Pencil/+ link to the right to create the new page.
  
 +The first thing you should do is create a top level header (the "H" button in the editor toolbar) and type the full name of the page in the header.  See the top of this page for an example.  When in doubt, check out the [[https://www.dokuwiki.org/tips:good_style|hints on good style]].
 +
 +A more complete guide to formatting syntax can be found [[https://www.dokuwiki.org/wiki:syntax|Here]].
 +
 +Use the "Preview" button at the bottom of the editing window to see your formatting as you make edits.
 +
 +Use the "Save" button at the bottom of the editing window to save your changes.
 +
 +**When creating the main ("Start") page in any section, please provide links to the sections and pages that are in that namespace.
 +**
 +
 +----
 +
 +===== Links =====
 +
 +Links to fully resolved URL's, such as http://vexwiki.org/ , are created automatically.
 +
 +To create a link, use opening and closing double square brackets:
 +
 +<code>[[http://vexwiki.org/]]</code>
 +
 +Use a pipe character ( | ) to add link text:
 +
 +<code>[[http://vexwiki.org/|Go to the site]]</code>
 +
 +
 +===== Information Design =====
 +
 +The key to keeping technical information organized and easy to manage and maintain is through using sound information design.  Dokuwiki does this through something called [[https://www.dokuwiki.org/namespaces|namespaces]].  Namespaces are essentially the directory structure of the wiki.  To use (i.e. to create a link to a page in a namespace), you must be certain to use the EXACT SAME TEXT as the namespace...well, sort of.  Let's say there is a directory, Main Directory, and a subdirectory, Directory Two, and a file, Start, in the subdirectory.  When creating a link to this namespace, separate the directory names with a colon (:).  For example:
 +
 +<code>[[Main Directory:Directory Two:Start]]</code>
 +
 +However, when dokuwiki initially creates these directory, it normalizes the directory name by automatically converting spaces to underscores and converting the entire string to lower case.  Thus, you could also use:
 +
 +<code>[[main_directory:directory_two:start]]</code>
 +
 +Note: "Start" is used as the default document in each namespace (directory).
 +
 +Now, let's say you want to create a new directory, "Directory Three" inside of "Main Directory".  Creating a link:
 +
 +<code>[[Main Directory:Directory Three:Start]]</code>
 +
 +and then clicking on the link in your finished page and following the procedure to create a new page (shown above) will create the new namespace/directory.
 +
 +===== Giving Credit (Footnotes) =====
 +
 +If you copy and paste information directly from another web page, or if you need to cite information in a footnote, use double parentheses ((http://www.vexwiki.org/wiki/syntax#footnotes))
 +
 +<code>
 +If you copy and paste information directly from another web page, or if you need to 
 +cite information in a footnote, use double parentheses ((http://www.vexwiki.org/wiki/syntax#footnotes))
 +</code>
 +
 +----
 +===== Contact Wiki Manager =====
 +Email Pete at <pruckelshaus@yahoo.com>
 +
 +----
 +===== Feedback & To-Do =====
 +[[Feedback and To-Do]]
  
  
  
start.1495409941.txt.gz · Last modified: 2017/05/21 22:39 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki