For Doc Devel Guide:
- Clarify first build documentation
- Add documententation how to publish
- AWT exception workaround for users
- Clarify which document tags need updating for new docs
- Expand description of how to get started
- Minor updates to reference to document directory from "template/" to "doc_dev_guide/"
For project:
- Add new document template (doc_template) for creating new specifications
- Add new document template for create errata (WG Notes)
- Rename the template/ directory to doc_devel_guide/
- Update README for new content and contact people
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Start 1.2 release (_pre1)
- Add subsection in Getting Started to include first build
- Add subsection in OpenPOWER Documentation Process on document packaging
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Minor update to rst_template/bk_main.xml to use namespace reference
"xl" instead of "xlink" to be compatible with herold output
- Create new opf_html2db.py script to convert singlehtml output of projects
using herold and then massage into OPF format for inclusion in rst_template
format
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Cleanup of revision history code (opf_docbook.py)
- Pull in GitHub clones and post build cleanups from Makefile (opf_docbook.py)
- Also drive Maven build with "tee" of output (opf_docbook.py)
- Add better status messages during build (opf_docbook.py)
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Open 1.1 version (_pre3)
- Document how to reference symbols by value.
- Describe extension to exploit extended symbols.
- Add sub-list examples.
- Describe extension for changing font-size in text.
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Open 1.1 version (_pre2)
- Add the mailing list to the abstract
- Add support for starting a new local project
- Add "git init" workaround to Troubleshooting for JAR dependency on git.
- Move "Understanding" section forward in document.
- Clarify "Workgroup POM" terminology.
- Further cleanup of "Master Template" naming change to "Document Development Guide".
- Additional explanation about publishing of documents, including flow charts
- Add recommendation of installation of Croscore fonts in new Install fonts section
- Include a policy on document versioning
- Add examples of special docbook extensions available in our tooling
- Increase the number of levels of sections in the TOC
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Issue #4: Clarify that the project link is private so that people won't suspect a
broken link. Provide directions on how to get access.
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Remove confidentiality, mark as public (Apache V2 license) in
anticipation of approval by TSC.
- Issue 13: Adjusted template document versioning to be variable based, but
still manually updates needed
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Bumped version to 0.9.4
- Added FO validation error debugging section with detailed steps
in ch_template_debugging.xml.
- Provided links to sub-sections in top of Debugging section,
again in ch_template.debugging.xml.
- Added License section with reference to Apache V2 license to README.md
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Updated Revision to 0.9.3 for working copy
- Convert to plugin version 1.3
- Added section on git commands
- Added section on OPF document process and reference appropriately
- Added links in Overview to main sections
- General document cleanup
- Convert graphics to SVG to improve clarity of scaled image
- Add DCO information to README.md file
- Add copyright and license statements to source files
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Updated Revision to 0.9.3 for working copy
- Added Abstract text to describe document and provide common
language for the role handling of the document in OPF
- Added section on git commands
- Added section on OPF document process and reference appropriately
- Added links in Overview to main sections
- General document cleanup
- Convert graphics to SVG to improve clarity of scaled image
- Add DCO information to README.md file
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
- Technical updates to reflect new project structure.
- Addition of project structure section to explain project relationships.
- General readability improvements.
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
This project has now been built to longer contain common files nor the
master POM file and now instead relies on the ../Docs-Master/ structure
when building. As such, the doc/common directory was removed and the
remaining files in doc/ were promoted to main level. Then, the top
POM file was converted to a "minimal" POM referencing the master-pom
in ../Docs-Master/. Finally, the template/ directory required a
slight update to the POM file (new name for parent minimal POM,
"workgroup-pom") and updated locations (../../Docs-Master/common) for
the common preface and appendix files in the book file (bk_main.xml).
For completeness, the README file was updated to ensure users of the
project understand it no longer is self-contained and must rely on the
Docs-Master project.
Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
Yong Lu