Map of the security docs planned for GT4
Draft: 24 September 2004
Release-related docs for GT security components
- Release manuals
- Other security-related docs in support of the release
- Atomic fragments of security-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
| Security Release Manuals | Purpose | WS Authentication & Authorization | Delegation Service | CAS | Pre-WS Authentication & Authorization | Credential Management | Utilities | ||
|---|---|---|---|---|---|---|---|---|---|
| Message- and Transport-Level Security | Authorization Framework | SimpleCA | MyProxy | GSI-OpenSSH | |||||
| Component Key Concepts Manual [draft template] |
Stable release documentation page that describes fundamental concepts of the components | GSI Standards Overview | |||||||
| 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 | Current draft | Current draft | Current draft | 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 | 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 | Current draft | Current draft | Current draft | Current draft |
Miscellaneous Security Docs
| Other security-related docs in support of the release | Purpose | WS Authentication & Authorization | Delegation Service | CAS | Pre-WS Authentication & Authorization | Credential Management | Utilities | ||
|---|---|---|---|---|---|---|---|---|---|
| Message- and Transport-Level Security | Authorization Framework | SimpleCA | MyProxy | GSI-OpenSSH | |||||
| 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 | Current draft | Current draft | Current draft | 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 | 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 | 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 | no draft available | no draft available | no draft available | no draft available | no draft available |
| Beta Release Testing Call [draft template not yet available] |
Identifies key aspects of a GT development release that warrant wide testing | N/A | N/A | no draft available | no draft available | N/A | N/A | N/A | N/A |
| Alpha Release Testing Call [template] |
Identifies key aspects of a GT development release that warrant wide testing | N/A | N/A | Current draft | Current draft | N/A | 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 | Current draft | Current draft | Current draft | Current draft |
Reusable Fragments of Security Content
| Atomic fragments of security-related content for reuse in multiple docs | Purpose | WS Authentication & Authorization | Delegation Service | CAS | Pre-WS Authentication & Authorization | Credential Management | Utilities | ||
|---|---|---|---|---|---|---|---|---|---|
| Message- and Transport-Level Security | Authorization Framework | SimpleCA | MyProxy | GSI-OpenSSH | |||||
| 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 | Current Draft | Current Draft | Current Draft | 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 | Current Draft | Current Draft | Current Draft | 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 | Current Draft | Current Draft | Current Draft | 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 | 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 | Current Draft | Current Draft | Current Draft | Current Draft |
| Component Dependencies Summary Fragment [template] |
Reusable fragment that summarizes technology dependencies for the component | Current Draft | Current Draft | Current Draft | Current Draft | Current Draft | Current Draft | Current Draft | Current Draft |
| Component Interface API Fragment [template] |
Reusable fragment that identifies the APIs of the component | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft |
| Component Interface WSDL Fragment [template] |
Reusable fragment that documents the WSDL associated the component | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft | 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 | Current draft | Current draft | Current draft | 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 | Current draft | Current draft | Current draft | 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 | Current draft | Current draft | Current draft | 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 | Current draft | Current draft | Current draft | Current draft |
| Component GUI Description Fragment [template] |
Reusable fragment that identifies the GUIs of the component | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft | Current draft |