This FAQ is to help explain the creation and use of documents in a Plato
- What are documents for ?
- Documents allow the author to upload one or more formats of a document
and a user to view this document.
- How do I define a document ?
- A document is defined in a similar way to other items, such as events
or actions. It can have a title, version, description and have up to
4 attached formats of the document. There are two user-definable qualifications
- category and status. You can also define its visibility.
- Why might I need more than one attachment?
- It might be useful to produce several formats of the document, perhaps
in HTML, Postscript or RTF, depending on the expected audience.
- Do I have to attach a document ?
- An alternative is to define a link to an external document or location
elsewhere on the web.
- What is the category?
- The category is a means for grouping classes of documents. You may
define new categories.
- What is the status?
- The status is the usual description of the stage of the document,
for example first draft, final draft, published. You may define new
- What is the visibility?
- See the general FAQ on visibility.
- What is the version?
- The version is the usual identification of the change history of the
- Is the version mandatory?
- No, but it is recommended and must be supplied to be able to created
linked versions of a document.
- What are linked versions of a document?
- It is encouraged that versions of a document are created by making
a new version of an existing document (use the Version link)
, rather than adding a new document (Add). The difference is
that by default only the latest version is seen on the summary page,
but with an indication "(+ implies others)" that there are
earlier versions. This allows more documents to be seen on the summary
page. Different versions retain the same document title and category
throughout their lifetme, but their status and visibility
- Who can update a document ?
- Only the owner and members of the maintainers group can update documents.
If you want to have multiple users working on a document then you can version a
document. Versioning allows users who have write level access to a document to add a new version even though they do not own the document.
- What appears on the home page ?
- As usual, a maintainer can configure the number of documents to appear
on the home page. The section contains the titles of the latest documents,
sorted by date of creation, together with links to their attached
- What appears on the summary page ?
- By default, all documents are displayed but only the latest version
of those with linked versions (see above). Documents
can be subsetted by category or age, grouped by category or all versions
can be shown. Sorting is by default by creation date, but the column
headings are links that allow the data to be sorted on different fields.
- What are archived documents?
- Documents can be archived, rather than deleted. An indication is given
on the summary page if any archived documents exist and the summary
can be switched to display them. Documents can be un-archived
at a later date.
Chris French - 26 Feb 2004