If you wish to contribute or participate in the discussions about articles you are invited to join SKYbrary as a registered user

Writing a SKYbrary Article

From SKYbrary Wiki

This article provides general guidance on writing articles for SKYbrary.

Do You Have Author Rights?

Whether a user can create new pages depends on the rights of the user group he or she belongs to. If you do not have the appropriate author rights, or are not comfortable writing in HTML, you can still contribute articles to SKYbrary by sending your material, in Microsoft Word, to the editor: editor@skybrary.aero

The editor will then place your article in Work in Progress.

New articles are created in the Work in Progress section and, once approved, are moved by the editor to the main section of SKYbrary. If you have been granted the appropriate rights, you can place your article directly into Work in Progress. For information on how to do this, see the help page: Help:Starting a new page.

Guidance on Writing an Article

While the majority of SKYbrary visitors are aviation professionals such as flight crew, engineers, or controllers, not all of them speak English as a first language. Authors should therefore avoid complicated language and the use of words which are not in common usage.

Article Structure

We try to adhere to a standard structure for SKYbrary articles:

Definition

An article will start with a Definition and/or a Description. The definition should explain the meaning of the term which is the subject of the article. For example, if the title of the article is Anabatic Wind then the Definition would be: "A warm flow of air travelling up a south facing slope of a hill or mountain." Where possible ICAO or HEIDI definitions should be used or a definition made by another appropriate authority.

Description

A short description of what the article is about.

Subsequent headings depend on the topic. However, if the article concerns a hazard, then we try to apply the following structure:

Effects

A short explanation of the threat posed by the hazard.

Defences

A review of the safety barriers in place

Scenarios

Some typical scenarios which illustrate the various ways in which the hazard creates a safety problem. These may be based on real events or be generic.

Contributing Factors

A summary of the factors which contribute to the likelihood of severity of the hazard.

Solutions

The most important part of the article is a summary of the solutions which can be employed to mitigate the residual risk.

Related Articles

All articles end with links to other related SKYbrary articles which the reader may find of interest. You can add these yourself or leave it to the Editor.

Further Reading

Here we include any reference documents that support the article. The Editor will upload these onto the SKYbrary bookshelf if you provide the URL.

As an example of a typical article using this structure click here.

If you have any questions about writing and submitting articles, contact the Editor: editor@skybrary.aero