Making a MID Wiki Page

Submit New Article

October 9, 2008 12:00 AM PDT


Contents

 

Page Creation Process

Here's an outline of the steps necessary to create a MID Wiki page. Using these easy steps as a guide you can join the MID community and help with the work.

Create an account in the Wiki Community. To do this you go to the software Wiki main page and create an account. If you are an Intel Employee you use your AMR account (amr#####). If you are outside of Intel you use your email address.

 

Determine Content

Start with the content you feel would be useful in the MID Wiki. Format and edit the content within a MS Word document.

If this article contains migrated content, use the "Track Changes" feature within MS Word. Migrated content from the internal Wiki to the external Wiki is much more difficult than authoring new content on the external Wiki, since two different Wiki systems are used, and therefore the Wiki markup in place for internal entries needs to be re-formatted to suite the external site. [ This needs some explanation, as why is this the case?]

 

Define a URL

Start by searching for an existing article or page on the external Wiki that might match your content. If one exists you should add your additional information there. If there's no place to add it, you'll need to create your own page.

You select the URL that will be used for the page you are about to create. The standard format is usually the intended title of the page separated by underscores, e.g. http://softwarewiki.intel.com/mid/Suitable_URL - Thus "Suitable URL" will be the resulting page title. You enter the URL in the browser as a destination and when the error page comes up you click the "edit this page" link. That's the process, a not found URL is turned into a new page.

 

Enter the Content

There is an entry box on the page where you can enter and edit your text. There are some formatting buttons at the top of the entry box but it is NOT a WYSIWYG editor. Use the "Show Preview" button at the bottom of the page to preview your changes and get things looking decent before you save the page. Try making a section, adding a bulleted list and perhaps a numbered list. It's also easy to look at the source to existing pages to see how the text in those is formatted.

Every time any changes are saved to the page, a History is kept which can be reviewed by anyone. Due to this, it's reasonable to try and do as much work offline as possible and post your edits in batches.

 

Summary Text Box

When you add your content to a page, or you modify previously existing content, put a brief summary of the changes you made in the Summary text box at the very bottom of the edit page. The summary field is used in history and change reports to show briefly what was done by the editors and unless you added an entirely new section it'll be blank waiting for you to add some explanation there [even if you added a new section, please update the text with something more explanatory]. It's easy to do and very helpful so please use this as a change tracking field.

 

Edit and Adapt Content

You can always go back and edit the content, adding and removing things as you need to adjust to include additional information or if things change.

I also suggest you click the "Watch this page" checkbox at the bottom of the page next to the Save Page button. This option will cause the system to send you an email if anyone makes changes to a page you are watching.

 

Content Review

For Intel Employees, run the content by a CCE reviewer to ensure Trademark and Branding requirements have been met.

 

Formatting Help

For help with the formatting of your page, open the Wikipedia Help ( http://en.wikipedia.org/wiki/Help:Contents) and Tutorial ( http://en.wikipedia.org/wiki/Wikipedia:Tutorial) pages in additional browser tabs for reference.