Best Practices
Adhere to all typeface and image best practices:
Bold face: Use for menu and button names
Italics: Use for system messages and titles
Respect the Oxford comma (red, white, and blue )
Embed hyperlinks into descriptive text where possible.
use → not -> for a series of selections
Use the code block macro for large blocks of code or text you expect people to copy paste
Insert emojis using the new text editor
Refer to hardware by the manufacturer: HP, Dell, MacOS, Windows, iOS, or Android (never MAC or PC)Apple.
Images should be resized before adding to the document. No borders. Use red (Hex code #FF0000) color and 3 pixels width for callouts (arrows, rectangles or ovals).
Ensure the language used is appropriate for a campus prioritizing DEI issues. Refer to the college’s Inclusive Language Guide.
1. New Page
Go to the space you want the new page to live in from the left content menu (don’t worry, you can easily move it later.)
Click the Create button at the top of the page, and select Page.
or Select Page from the drop-down
2. Restricting Access while creating a new page
Click on the lock
icon under the search bar to open the Restriction Manage Access windowClick on the drop down arrow and choose “Only specific people can view or edit “
In the “Enter a person or group” field and type Wiki-CITEditors
Select
and clickThis will add that group with edit access
Click
to save and close the Manage access window
3. Insert the Self Help Article Template
From your new page, scroll to the bottom and click on the Self Help Article Template to place it on your page.
Please do not alter the names of the provided section headers, nor change the template's default font family or sizes.
Delete optional ones that are not used.
Create additional headings with Heading 1 format.
3a. Apply the Self Help Article Template
Give this page a title
Enter a descriptive page title
The title should start with the topic name then the action
Excerpt
Replace this text with a friendly overview of what the article is about in this section
Before You Start
Optional section using a bulleted list.
Remove if not needed
Steps
Break down your steps in a logical manner.
Use a numbered list for ease of reference.
Insert your steps.
You can also copy and paste or drag-and-drop images into your instructions.
For more than 10 steps, consider breaking into different sections.
Info Panels:
Use to highlight information in a colored panel.
Two info panels are included in the Self-Help Template
To add more info panels, Click the + sign on the top navigation menu and select Info Panel:
Notes
Optional section using a bulleted list.
Remove if not needed
Related Topics
This section is optional. Related articles appear here based on the labels you select. You must click to edit the macro and add or change labels.
When approved, remove viewing restrictions
Do not forget to update labels! Look at /wiki/spaces/HELP/pages/77922493 for a list of currently used labels.
Is it time to review a Self Help document you are responsible for? /wiki/spaces/HELP/pages/77922493
Help
the More Help section should use the Include Page macro to include the More Help or More Brightspace Help page
Because the header for this section exists within the More Help pages, it's unnecessary to create the header for this section.
Page Properties
On each page, there are important properties.
Owned by (top of page) change to the manager of the group responsible for content
Owner (area) refers to the area that is the primary owner of the document
Reviewed by use the @ to tag someone
Review Date the key stroked “//” will bring forward a date picker
3. Publishing
When you first publish a page or blog post draft by selecting Publish…
, you’ll see several publishing options and settings in one place.Choose where the page or blog post will go.
Choose who can see the page or blog post after publishing.
Add version comments to describe the page you are publishing or updating. These comments can be helpful later when reviewing a page’s history.
Schedule a publish for a future date and time.
Convert a page into a blog post.
Other than location and access, all fields in the publish dialog are optional. Spending the time to properly adjust your settings up front can save time on future updates.
Update
Once a page or blog is published for the first time, all subsequent changes made to it are known as updates.
To update a published page or blog with new edits based on the settings you selected or simply confirmed when publishing, select Update from the top right toolbar of the editor.