Developing Documentation is a combination of editing existing pages that others have created, and/or creating new pages.
Wiki pages are written in a simple, plain-text syntax with a few extensions, that allows structuring the page and pleasant formatting while retaining high readability of the page source. When you edit a page and save your changes, the previous content will not be lost. Instead it will be saved as an old revision of the page in the attic and can still be viewed or even restored.
Before you edit your first “real” page in the wiki, you should try out the possibilities in the playground. The playground is provided so that users can test things and play around to their heart's content. The playground is wiped out on a daily basis, so feel free to try out things there, and don't worry about making any permanent damage.
To edit a page in the wiki, simply log in (you must be logged in, with a valid myAnalog account to edit wiki pages), and either :
Clicking on either button will switch to editing mode for this page, and you can change the wiki source of this page in an embedded editor. Before saving changes (by clicking on the Save button), examine your changes, by looking at a Preview or see a difference, by clicking on the Changes button.
There are two ways to create new pages. Both require that you are logged into the wiki and have special access (ie, normally that means you are an Analog Devices employee).
Just like paper documentation, the wiki is able to differentiate between revisions of a document that are Under Development (which is private, typically for a unreleased product), Draft, and those that are Approved.
Public pages will always have a banner at the top of each page, with information about the Approval/Draft status. The banner is color-coded with an icon: A Green check mark for the latest approved version, and an orange exclamation point for all others.
The development process is something like:
When a page is initially created on the Wiki, it will only be visible to Analog Devices employees until it is approved. A message at the top of the page with the “draft” notice will note that the content can only be seen internally. A page can sit in this state forever, and be edited as many times as the creation team would like.
Once a page has been approved (by an ADI employee), it will be public and visible to both internal and external audiences. This allows documentation to be created over days/weeks before it becomes “public”.
Once content is public, any edits made to it will also be public.
Anyone logged into the wiki, can edit a page, and their version will be saved as a draft. You do not need to be an Analog Devices employee to edit a page. If you see a problem - please fix it.
Anyone not logged into the site will see the latest approved revision by default (unless there isn't one). All users can still view any revision of a page if they specifically request it -- whether or not it is approved.
Any Analog Devices Employee can Approve a page. You do so by clicking the “Approve document” link on the page header. Multiple people can approve the same page.
In some cases, the editing of a page is impossible. This can be mainly for these reasons :