VEX Robotics Wiki

Covering VEX IQ, VEX EDR, and VEX Pro

User Tools

Site Tools


start

Welcome

The VEX Robotics Design System offers students an exciting platform for learning about areas rich with career opportunities spanning science, technology, engineering and math (STEM). These are just a few of the many fields students can explore by creating with VEX Robotics technology. Beyond science and engineering principles, a VEX Robotics project encourages teamwork, leadership and problem solving among groups. It also allows educators to easily customize projects to meet the level of students’ abilities. The affordable VEX platform is expanding rapidly and is now found in middle schools, high schools and university labs around the globe. Robotics hobbyists also appreciate the advanced capabilities of the VEX System.1)


Main Sections

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 here and the REC Foundation Style Guide can be found here. Consult either source if in doubt.

Content Style Guide

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 hints on good style.

A more complete guide to formatting syntax can be found 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 to fully resolved URL's, such as http://vexwiki.org/ , are created automatically.

To create a link, use opening and closing double square brackets:

[[http://vexwiki.org/]]

Use a pipe character ( | ) to add link text:

[[http://vexwiki.org/|Go to the site]]

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 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:

[[Main Directory:Directory Two:Start]]

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:

[[main_directory:directory_two:start]]

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:

[[Main Directory:Directory Three:Start]]

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 2)

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))

Contact Wiki Manager

Email Pete at pete@vexwiki.org


Feedback & To-Do

start.txt · Last modified: 2017/05/30 14:09 by pruckelshaus