Difference between revisions of "Help:Contents"
From Protocase Designer Documentation
m |
m |
||
Line 1: | Line 1: | ||
+ | |||
+ | ==Enclosure Terminology== | ||
+ | {| border="1" cellpadding="5" cellspacing="0" | ||
+ | !Term | ||
+ | !Usage | ||
+ | !Example | ||
+ | |- | ||
+ | |back||AVOID. See ''rear''||N/A | ||
+ | |- | ||
+ | |back panel||AVOID. See ''rear panel''||N/A | ||
+ | |- | ||
+ | |bottom||Feature||Use the view commands to view the bottom of your enclosure. | ||
+ | |- | ||
+ | |bottom panel||Part||Click the bottom panel to open the Face Editor. | ||
+ | |- | ||
+ | |bracket||Part||Click the bracket to open the Face Editor. | ||
+ | |- | ||
+ | |chassis||Part||Click the chassis to open the Face Editor. | ||
+ | |- | ||
+ | |color||Parameter||You can change the color of each Part.<br>New Assembly dialog box:<br>Color: Default<br>Color: Chassis<br>Color: Left/Right<br>Color: Top<br>Color: Bottom<br>Color: Front<br>Color: Rear<br>Color: Divider | ||
+ | |- | ||
+ | |colour||AVOID. See ''color''||N/A | ||
+ | |- | ||
+ | |cover||Part||Click the cover to open the Face Editor. | ||
+ | |- | ||
+ | |default||Parameter option||Select the default color for your enclosure. | ||
+ | |- | ||
+ | |depth||Parameter||Enter the depth for your enclosure.<br>New Assembly dialog box:<br>Depth<br>Depth: Bottom<br>Depth: Top<br>Depth: Recessed | ||
+ | |- | ||
+ | |extrusion||Part||Click the left extrusion to open the Face Editor. | ||
+ | |- | ||
+ | |face||Feature||You can draw features on the face using several drawing tools. | ||
+ | |- | ||
+ | |flange||Part||Select a color for the left flange. | ||
+ | |- | ||
+ | |flange mount||Part||Select a color for the flange mount. | ||
+ | |- | ||
+ | |front||Feature||Use the view commands to view the front of your enclosure. | ||
+ | |- | ||
+ | |front panel||Part||Click the front panel to open the Face Editor. | ||
+ | |- | ||
+ | |gauge||Parameter||Select a gauge to use as the default thickness for your enclosure. | ||
+ | |- | ||
+ | |height||Parameter||Enter the default gauge for your enclosure.<br>New Assembly dialog box:<br>Height<br>Height: Front<br> Height: Rear<br>Height: Recessed | ||
+ | |- | ||
+ | |left extrusion||Part||Click the left extrusion to open the Face Editor. | ||
+ | |- | ||
+ | |left panel||Part||Click the left panel to open the Face Editor. | ||
+ | |- | ||
+ | |material||Parameter||Select a material for your enclosure. | ||
+ | |- | ||
+ | |metal type||AVOID. See ''material''||N/A | ||
+ | |- | ||
+ | |mounting hardware||Part||You can add mounting hardware to your enclosure. | ||
+ | |- | ||
+ | |panel||Part||Select a panel to open the Face Editor. | ||
+ | |- | ||
+ | |rear||Feature|| | ||
+ | |- | ||
+ | |rear panel||Part|| | ||
+ | |- | ||
+ | |right extrusion||Part||Click the right extrusion to open the Face Editor. | ||
+ | |- | ||
+ | |right panel||Part||Click the right panel to open the Face Editor. | ||
+ | |- | ||
+ | |self-clinching fastener||Part||You can add self-clinching fasteners to your enclosure. | ||
+ | |- | ||
+ | |side||Feature|| | ||
+ | |- | ||
+ | |silkscreen||Feature||You can add custom silkscreen to your enclosure. | ||
+ | |- | ||
+ | |style||Parameter||We build enclosures of all styles. | ||
+ | |- | ||
+ | |thickness||Parameter||Select a gauge to use as the default thickness for your enclosure.<br>New Assembly dialog box:<br>Thickness<br>Thickness: Default<br>Thickness: Front<br>Thickness: Cover<br>Thickness: Chassis<br>Thickness: Rear | ||
+ | |- | ||
+ | |top||Feature||Use the view commands to view the top of your enclosure. | ||
+ | |- | ||
+ | |top panel||Part||Click the top panel to open the Face Editor. | ||
+ | |- | ||
+ | |type||AVOID when used for enclosure. See ''style''||N/A | ||
+ | |- | ||
+ | |width||Parameter||Enter the width for your enclosure. | ||
+ | |} | ||
+ | |||
== Style Guide == | == Style Guide == | ||
Line 98: | Line 182: | ||
*photo-fan-60mm.png | *photo-fan-60mm.png | ||
*photo-powersupply.png | *photo-powersupply.png | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Revision as of 14:41, 4 September 2015
Contents
Enclosure Terminology
Term | Usage | Example |
---|---|---|
back | AVOID. See rear | N/A |
back panel | AVOID. See rear panel | N/A |
bottom | Feature | Use the view commands to view the bottom of your enclosure. |
bottom panel | Part | Click the bottom panel to open the Face Editor. |
bracket | Part | Click the bracket to open the Face Editor. |
chassis | Part | Click the chassis to open the Face Editor. |
color | Parameter | You can change the color of each Part. New Assembly dialog box: Color: Default Color: Chassis Color: Left/Right Color: Top Color: Bottom Color: Front Color: Rear Color: Divider |
colour | AVOID. See color | N/A |
cover | Part | Click the cover to open the Face Editor. |
default | Parameter option | Select the default color for your enclosure. |
depth | Parameter | Enter the depth for your enclosure. New Assembly dialog box: Depth Depth: Bottom Depth: Top Depth: Recessed |
extrusion | Part | Click the left extrusion to open the Face Editor. |
face | Feature | You can draw features on the face using several drawing tools. |
flange | Part | Select a color for the left flange. |
flange mount | Part | Select a color for the flange mount. |
front | Feature | Use the view commands to view the front of your enclosure. |
front panel | Part | Click the front panel to open the Face Editor. |
gauge | Parameter | Select a gauge to use as the default thickness for your enclosure. |
height | Parameter | Enter the default gauge for your enclosure. New Assembly dialog box: Height Height: Front Height: Rear Height: Recessed |
left extrusion | Part | Click the left extrusion to open the Face Editor. |
left panel | Part | Click the left panel to open the Face Editor. |
material | Parameter | Select a material for your enclosure. |
metal type | AVOID. See material | N/A |
mounting hardware | Part | You can add mounting hardware to your enclosure. |
panel | Part | Select a panel to open the Face Editor. |
rear | Feature | |
rear panel | Part | |
right extrusion | Part | Click the right extrusion to open the Face Editor. |
right panel | Part | Click the right panel to open the Face Editor. |
self-clinching fastener | Part | You can add self-clinching fasteners to your enclosure. |
side | Feature | |
silkscreen | Feature | You can add custom silkscreen to your enclosure. |
style | Parameter | We build enclosures of all styles. |
thickness | Parameter | Select a gauge to use as the default thickness for your enclosure. New Assembly dialog box: Thickness Thickness: Default Thickness: Front Thickness: Cover Thickness: Chassis Thickness: Rear |
top | Feature | Use the view commands to view the top of your enclosure. |
top panel | Part | Click the top panel to open the Face Editor. |
type | AVOID when used for enclosure. See style | N/A |
width | Parameter | Enter the width for your enclosure. |
Style Guide
The following styles and grammar rules are used in the Protocase Designer documentation. Most styles and rules are referenced directly from the Microsoft Manual of Style.
Menus
- Menus contain commands, not menu items.
- Use click to describe user interaction with menus and menu commands. Do not use choose, select or pick. To open a submenu the user points to a command on the main menu, then clicks the appropriate command on the submenu.
- Use lowercase for the word menu when referring to a specific menu.
- Refer to unavailable commands and options as unavailable, not as dimmed, disabled, or grayed, unless describing their appearance.
- Always surround menu names with the words the and menu.
- Bold menu names and commands.
Example
- On the File menu, click Open.
- On the View menu, point to Sort by, and then click Date.
Toolbars
- General toolbars contain buttons.
- A toolbar button with a submenu is called a menu button.
- Use click to describe user interaction with toolbar buttons except with the Drawing toolbar.
- In general, do not use the words the and button with toolbar buttons.
- Use lowercase for the word toolbar.
- The Drawing toolbar contains tools.
- Use select to describe user interaction with tools on the Drawing toolbar.
- Always surround tool names with the words the and tool.
- Bold toolbar names, buttons, and tools.
Example
- On the Standard toolbar, click New.
- On the Drawing toolbar, select the Rectangle tool.
Check Boxes
- Two words. Use the identifier, check box, not just box.
- Use select and clear, NOT turn on and turn off, mark and unmark, check and uncheck, or select and deselect.
- Always include check box with the label name.
Example
- Select the Spaces check box.
- Click to clear the Bookmarks check box.
Mouse Terms
- Use drag, not click and drag. The drag action includes holding down a button while moving the mouse and then releasing the button.
- Use rotate to describe interaction with middle wheel button.
- Use wheel button to refer to the third or middle button on the mouse. Users rotate the wheel itself, and they click the wheel button.
- Refer to the mouse pointer as the pointer.
- Use click, not click on.
Example
- To see the Control menu, right-click anywhere in the window.
- Click in the window to make it active.
- Right-click the selected text, and then click Copy.
- Rotate the wheel button forward to scroll up in the document.
Title and heading style and conventions
- Use sentence-style capitalization for titles and for headings.
- Use imperative constructions for procedure titles.
- Describe what the user wants to do in the user's language.
Example
- Draw circles
- Reset view
Procedures
- Title: identify the task using imperative
- Describe the task
- One or two sentences
- Explain when and why
- Cross-reference to related tasks
- List prerequisites
- Highlight hazards
- Write the steps (use Template:Procedure)
- Use clear, present tense imperatives
- e.g. Set the starting time vs. Users should select a starting time
- Keep sentences short
- Group steps based on complexity
- Limit number of steps (<10)
- Make sure you can perform each step
- Do not tell the user every way to perform task (i.e. menu, button, etc.), unless the procedure is explaining one specific task.
- Fake step 2 if there are a lot of 1 step procedures
- Use clear, present tense imperatives
Image Naming Conventions
Examples
Screenshots: png files
- button-editface.png
- button-acceptclose.png
- dialogbox-editproperties.png
- dialogbox-showparts.png
- tool-circle-construction.png
- tool-edit.png
- window-faceeditor-ushape-rear.png
- window-main-rackmount-nocover.png
Sketches: jpg files
- sketch-powersupply-pcb.jpg
- sketch-mounting-dimensions-rear.jpg
Photos: jpg or png files
- photo-fan-60mm.png
- photo-powersupply.png