Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
COSMOS Documentation Plan
Welcome to the COSMOS documentation planning Wiki page.
Contents
Purpose
The purpose of this page is to provide information to develop the following documents to support the COSMOS GA.
- Installation Guide
- User's Guide
- Development Guide to support the COSMOS GA.
Provided are references to COSMOS document planning, scheduling, document links and other resources to assist in development of the documents.
The development content for the documentation will be developed on the Wiki.
The User's Guide and Development Guide contents will be inputted into a DITA format using the Epic editor. DITA content requires the content to be developed as topic-based writing. See references below for more information on DITA. PDF files will be provided for future reviews and online helps created for final output.
COSMOS document planning references
Document links
- COSMOS Manual Guide
- Wiki COSMOS document naming convention and Category association
- COSMOS Documentation Category listing
- Document files test procedure
Document outlines
The following templates shows the current planned layout for the User's Guide and Development Guide.
Document Guidelines and References
Use the following reference to learn about the Eclipse standards in writing, graphics and translations.
- Eclipse Doc Style Guide
- Graphic Guidelines for Documents
- How to add things to the Eclipse doc
- Eclipse Doc checklist
- How to prepare your code and documentation for translation
- Eclipse User Interface Guidelines
- How to Internationalize your Eclipse Plug-In
- UI Graphic Design and Style
- User Interface Guidelines
- Foundation Legal Frequently Asked Questions (FAQ
Other resources
The following resources are to assist you in developing documentation.
- Eclipse Document Style Guide gives the style conventions to be used in Eclipse documents and helps.
- DITA References provides references about DITA and samples of how to write DITA content.
- Wiki tips and examples is a quick reference to Wiki information.