GUIDELINES for Editors

Editing

To edit any given page, look at the bottom for a button labeled "edit this page." This will take you to a form screen with the HTML contents of the page displayed like this:

All editing of the page is done inside the Edit box (see above). Most of the content is in plain text, but use of HTML allows us to indent (using <blockquote>), highlight heading (using <B> for bold) and link to resources such as:

<a href="http://www.organization.org/">Link Name</a>

The <a href...> is called the anchor tag. It is used to create an external link (the internal links in Wiki are done using *name*). These represent the primary offerings of bmesource.

Link Names

Link names are critical and should be standardized around the following conventions:

Include source in link name. The source should be shortened as much as possible, acronyms may be used for easily recognizable entities (such as UCLA) or if not easily recognizable, defined in the acronyms_used page accessible from the homepage. Exceptions to this rule are internal pages.

The rest of name should match the title of the resource as closely as possible. However, if the title is long, feel free to shorten to a reasonable length. Most link names are under 30 characters. Choose a name that describes the resource in the context that it is in. For instance, if the title of the Document is Understanding Congestive Heart Failure, but it's on the Congestive Heart Failure page, using the term CHF is appropriate in the link name.

Some examples:

• ClevelandClinic: Understanding CHF
• ACC/AHA Guidelines: Evaluation And Management of Patients With CHF

Link names for internal pages on bmesource do not need a source reference. The name, however, is required to be unique on the site. Therefore, when creating a new page within bmesource determine whether such a name might already exist. The best way to do this is to try the name in your browser window:

http://www.bmesource.org/name_you_are_trying

On the other hand, just because you don't find it, doesn't necessarily mean it's a good name. Names that are not specific to their area should be avoided. So you should not create a page called, for instance, Images or Video or Links. Instead, the name should reflect the section or topic such as Balloon_Images or Surgery_Video.