Map of the information services docs planned for GT4
Draft: 24 September 2004
Release-related docs for GT info services components
- Release manuals
- Other information services-related docs in support of the release
- Atomic fragments of info services-related content for reuse in multiple docs
Please tell us what you think
If you wish to offer comments or suggestions regarding our documentation plans, please create a new bugzilla entry. Ideas for contributions are also welcome!
Release Manuals
| Information Services Release Manuals | Purpose | WS MDS (MDS4) | Pre-WS MDS (MDS2) | ||||
|---|---|---|---|---|---|---|---|
| Index Service | Trigger Service | Aggregator | Archive Service (Tech Preview) |
WebMDS (Tech Preview) |
|||
| Component Key Concepts Manual [draft template] |
Stable release documentation page that describes fundamental concepts of the given component | Current draft | |||||
| Component Developer's Guide [draft template] |
Stable release documentation page that describes how to use the programming interfaces of the component (e.g., APIs, service interfaces, etc.) | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| Component Sysadmin Guide [draft template] |
Stable release documentation page that describes how to install, deploy and maintain a given component | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft |
| Component User's Guide [draft template] |
Stable release guide to component interfaces that support human-driven interactions, such as command-line tools, GUIs, etc. | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
Miscellaneous Info Services Docs
| Other data-related docs in support of the release | Purpose | WS MDS (MDS4) | Pre-WS MDS (MDS2) | ||||
|---|---|---|---|---|---|---|---|
| Index Service | Trigger Service | Aggregator | Archive Service (Tech Preview) |
WebMDS (Tech Preview) |
|||
| Stable Component Release Notes [template] | Describes implementation details to existing and potential users of a component distributed as part of a new stable release | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| GT4 Component Fact Sheet [template] | Provides useful implementation details about a component in advance of the next stable release | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft |
| Component Quality Profile [draft template not yet available] |
Presents current reports on test coverage, resource and memory leak analysis, bounds checking, and performance profiles | no draft available | no draft available | no draft available | no draft available | no draft available | no draft available |
| Full-Featured Release Testing Call [draft template not yet available] |
Identifies key aspects of a GT development release that warrant wide testing | no draft available | no draft available | no draft available | N/A | N/A | N/A |
| Beta Release Testing Call [draft template not yet available] |
Identifies key aspects of a GT development release that warrant wide testing | no draft available | no draft available | no draft available | N/A | N/A | N/A |
| Alpha Release Testing Call [template] |
Identifies key aspects of a GT development release that warrant wide testing | Current draft | Current draft | Current draft | N/A | N/A | N/A |
| Component Public Interface Overview [template] |
Identifies the public interfaces for the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
Reusable Fragments of Info Services Content
| Atomic fragments of data-related content for reuse in multiple docs | Purpose | WS MDS (MDS4) | Pre-WS MDS (MDS2) | ||||
|---|---|---|---|---|---|---|---|
| Index Service | Trigger Service | Aggregator | Archive Service (Tech Preview) |
WebMDS (Tech Preview) |
|||
| Brief Component Overview Text Fragment [template] |
Single paragraph that provides an overview of the component for reuse across multiple docs | Current draft | Current draft | Current draft | Current draft | no draft available | Current Draft |
| Component Feature Summary Fragment [template] |
Provides an overview of the features of the component for reuse across multiple docs | Current Draft | Current Draft | Current draft | Current draft | no draft available | Current Draft |
| Tested Platforms Fragment [template] |
Reusable fragment that summarizes the platforms on which the component has been tested | Current Draft | Current Draft | Current Draft | Current Draft | no draft available | Current Draft |
| Component Usability Improvement Summary Fragment [template] |
Reusable fragment that summarizes the usability improvements for this component | no draft available | no draft available | no draft available | no draft available | no draft available | no draft available |
| Component Backward Compatibility Summary Fragment [template] |
Reusable fragment that summarizes changes to the public interface in this release | Current Draft | Current Draft | Current Draft | Current Draft | no draft available | Current Draft |
| Component Dependencies Summary Fragment [template] |
Reusable fragment that summarizes technology dependencies for the component | Current Draft | Current Draft | Current Draft | Current Draft | no draft available | Current Draft |
| Component Interface API Fragment [template] |
Reusable fragment that identifies the APIs of the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| Component Interface WSDL Fragment [template] |
Reusable fragment that documents the WSDL associated the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| Component Interface Command-Line Tool
Fragment [template] |
Reusable fragment that describes the command-line tools for the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| Component Configuration Interface
Fragment [template] |
Reusable fragment that identifies the configuration options for the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| Domain-Specific Interface Description
Fragment [template] |
Reusable fragment that identifies the domain-specific interface data of the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| Component Interface to Environment
Variables Fragment [template] |
Reusable fragment that identifies the interface to environment variables by the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |
| Component GUI Description Fragment [template] |
Reusable fragment that identifies the GUIs of the component | Current draft | Current draft | Current draft | Current draft | no draft available | Current draft |