userguideimport21

1. Introduction

1.1. Overview

Tome.host is a SaaS ("software as a service") designed to simplify the process of creating and maintaining technical manuals, user guides and other structured documentation.

Unlike traditional content management systems, data is structured in sections, which can be nested to any number of levels, rather than pages.

1.2. Advantages over conventional documentation

  • up-to-date - user always sees the latest published information unless paper or PDFs and Word docs, where users can retain old versions and may be unaware of updates
  • simplicity - the system takes care of the numbering and formatting, so users can concentrate on the content
  • speed - small edits can be made and published in seconds
  • multi-user - teams can work simultaneously from multiple locations, with source-control style permissions stopping users from overwriting each others' work
  • usability - direct web links to any heading at any level, layout reformats for optimum usage on mobile and tablet device

 

1.3. Basic concept

tome.host draws its basic concept from source-control - a system familiar to computer programmers which allows teams of programmers to work simultaneously on large development projects without overwriting each others work.

There are two areas of content - 'draft', which is the working content that authors make changes to, and 'published', which is the live version that the public actually sees.

The process of publishing essentially copies any changes made to the draft version over to the live public version.

1.4. Cost

At present, tome.host is free. In future, we will add additional features which will be available under paid plans too.

 

@4. Multiple users and permissions‍ 

  

@1.1. Overview‍ 

2. Registrationnn

To create or contribute content to a tome, you must have a user account. You can sign up from tome.host for an account. Alternatively, if someone invites you to contribute to a tome, you will be sent a link that will allow you to create an account and join a tome.

testhttp://localhost.com:63046/Downloads/2035__fs_1503498477_3043.log/d

3. Creating and Managing Tomes

3.1. What is a tome?

A tome is defined in the dictionary as "a book, especially a large, heavy, scholarly one."

We use the term "tome" to refer to a named container of content, consisting of nested headings, and the various text, image and other content under them.

Typically you would create a tome for a particular product or service, to hold instructions or other technical information.

3.2. Creating a tome

To create a tome, go to the "My Tomes" page and click the "New Tome" button.

Tome names must be between 4 and 100 characters long, and may contain only upper or lowercase letters, numbers, or dashes.

The name you choose will form the address for the tome, for example a tome named "userguide", has the address:

http://userguide.tome.host

(the limitation on the characters that tome names can contain is because the tome name is used as the subdomain of the tome address)

Because the tome name is used in URLs, you should ensure that it is something that is broadly descriptive or relevant to the content.

You can change a tome name later, as long as the new name you want is not already taken. However, it is strongly advised not to do this once a tome is established, as existing links in search engines, forums and so on to your tome will no longer work. It makes sense to think carefully about your tome name and get it right first time.

3.3. Importing a tome

Some DocBook XML files exported from third-party applications may not be recreated in their entirety within tome.host, depending on what features and types of sections they contain.

You can import a DocBook XML document to create a new tome. Because tome.host can also export a tome as DocBook XML, you can use this to clone a tome and create a new tome based on the original. To start the process, click the 'import' button at the top of the 'My Tomes' page, name your new tome, and browse to select the file.

 
powered by tomehost