Welcome to the Help Center! This way of doing documentation is a bit different from what you may be used to, so please read this document to understand how to contribute.

Quick Start

For the impatient, here's the bare minimum you should know:

• You normally need to be logged in.
• There are several different documentation types, most are self-explanatory, but pay attention to the difference between a How-to and a Tutorial (explained below).
• To add a piece of documentation/help, go into the relevant section, make sure there isn't already an existing entry about what you want to add, and use the button at the top right to add (normally says Add FAQ or similar).
• Add your content, and save it. This edit/view cycle can be performed as many times as you like, until you are happy with the result.
• Make sure you Submit your document for publication when you are done - top right pulldown in the content area.
• A reviewer will then pick up the document, and publish it unless the content needs to be improved.
• If somebody adds comments to your entry later, you will be notified by e-mail.

What type of item is my documentation?

Below is a description, usage and example for each type.

Frequently Asked Question (FAQ)

An FAQ is a short question with a 1-2 paragraph answer. You can add several questions to a FAQ area and group the questions into sections:

    FAQ Example
    Question: What is PlanBookTravel?

    Answer:
    PlanBookTravel is a place to provide you with resources for your travels, publishing pictures and your blog, and reviewing locations for other users. You can rate others Reviews, and the best reviews can replace the existing information for a location.

HowTo

A HowTo is a one-page description on how to accomplish something, but is folderish, so Files/Images can be attached. It's usually very brief and to-the-point.

Typical How-Tos:

• How to set up multiple Photo Albums
• How to write a good review

Tutorial

A tutorial is a multi-paged article with lots of detail. The tutorial is more in-depth than a How-to, and may cover the conceptual aspects of the task, in addition to the practical steps to get the job done.

If you are unsure of the difference of a How-to and a Tutorial, think about it as the difference between a recipe that only teaches you what ingredients are needed, and how to bake the cake (How-to), and an article telling you about the history behind cakes in general, that may or may not teach you how to actually bake one (Tutorial).

Typical Tutorials:

• Managing your blog in an effective way.
• Collating your holiday information and passing that on to family and friends.

Reference Manual

A reference manual is a definitive piece of documentation for some part of the technology, and tends to be several pages in length, with sections breaking up the content. This is by far the rarest documentation type.

Help Link

A help link is a link (either external or internal). It is different from a standard PlanBookTravel link in that it can have section and version information.

Typical Help Links:

• Writing good Articles
• Taking good pictures

Error Reference

An error reference is meant to be the explanation of a particular error, with details on how to fix it, if relevant.

Typical Error References

• Expected sequence, got integer
• FS Page Template has errors: Compilation failed

Glossary Definition

A glossary definition describes a particular term used as concisely as possible.

Typical Glossary Definitions:

• PBT: Plan Book Travel
• Workflow: The process of moving a Review or Photo from being a draft, to published on the site.