Error: Macro BackLinksMenu(None) failed

compressed data is corrupt

Error: Macro TicketQuery(summary=UNPLANNED_USER_DOC_STRUCTURE_R0, format=table, col=summary|owner|status|type|component|priority|effort|importance, rows=description|analysis_owners|analysis_reviewers|analysis_score|design_owners|design_reviewers|design_score|implementation_owners|implementation_reviewers|implementation_score|test_owners|test_reviewers|test_score|) failed

current transaction is aborted, commands ignored until end of transaction block

Analysis

This is the structure for user documentation on the Sophie 2 website.

Overview

User documentation will be online in the Trac wiki until the final release. To start, it will follow the outline for the Sophie 1.0 documentation (online here in PDF form: ​http://sophieproject.cntv.usc.edu/files/SophieHelp1.0.3.pdf ). Major sections (e.g. 2. Working with Sophie, 3. Working with Frames) will each get a page with an introduction and a table of contents. Subsections in each section (e.g. 2.1. Sophie's Interface, 2.2. Halos & Huds) will each get their own page.

As Sophie Reader and Sophie Server begin to exist as separate applications, each will get their own separate documentation so that users can learn about each separately if they want to.

This is a numbered outline that explains what will be in the Sophie 2 documentation and where.

Task requirements

• The user documentation will eventually need to provide information for users of Sophie Author, Sophie Reader, and Sophie Server; eventually, these need to become three separate documents (although interconnected). For now, I'm going to start with a single document for Sophie with the idea that this is going to be split into sections.

• There needs to be a logical page-naming structure if this is to work as a wiki; this should be extensible.

• There needs to be a (possibly rudimentary) style guide covering how images are handled, how numbering is handled, similar issues. Style guide isn't exposed to the public.

Task result

For this task, there will be a sample outline (as a page in the wiki) and a sample style guide (as a page in the wiki). From this we can start work on real documentation.

Implementation idea

For a sample outline, see here: UNPLANNED_USER_DOC_STRUCTURE_Outline?

For a sample style guide, see here: UNPLANNED_USER_DOC_STRUCTURE_StyleGuide?

Related

UNPLANNED_USER_DOC_SAMPLE_R0 (sample of user documentation)

How to demo

Look at the outline and style guide.

Design

This can be done in the Trac wiki for now.

Implementation

For a sample outline, see here: UNPLANNED_USER_DOC_STRUCTURE_Outline?

For a sample style guide, see here: UNPLANNED_USER_DOC_STRUCTURE_StyleGuide?

Testing

Comments

Outline is essentially as it was in Sophie 1.0 - no changes have been made yet.