Topics

In Paligo, you write your content in topics. Topics are containers that should be used to contain one section of information. For example, if you were writing a "Mars Travel Manual", you might have sections for "About Spaceflight", "Space Safety", "The Mission Control Center" and many more. Instead of writing all of these sections in one large file, you would write each one in a separate topic. For best practice, each topic should focus on one subject or task.

mission-control-center-topic.jpg

A topic is a container for your content such as text, images, etc.

You create content inside a topic by adding elements for paragraphs, images, procedures, bullet lists, etc.

To create a finished "document", you assemble a collection of topics in a publication. If you think of your content as a traditional printed user guide, the publication represents the entire guide and its structure is where you organize the table of contents. The topics are your "building blocks" of content and you can choose to include or exclude them from as many different publications as you like. This is why topics are so important for content reuse. They allow you to use the same piece of information in many different publications, without having to create copies of it. There is one "single source of truth".

mission-control-center-pub.jpg

A Publication is a collection of topics.