Difference between revisions of "Documentation/Dashboard/Help Content Cleanup"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Resources)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''Help Content Cleanup Project'''
+
{{DraftPage|EN}}
 +
 
 +
{{Documentation/Project
 +
|Name=Help Content Cleanup
 +
|Owner=[mailto:fpe@openoffice.org Frank Peters]
 +
|Status=Proposed
 +
}}
 +
 
 +
=The Help Content Cleanup Project=
 +
__NOTOC__
 +
 
 +
==Summary==
 +
This project looks into cleaning up the content of the help as available in the helpcontent2 source code module.
 +
 
 +
Currently, the help content includes numerous formatting flaws, such as
 +
* inconsistent usage of span elements
 +
* inconsistent usage of image size attributes
 +
* multiple insignificant spaces introduced by formatting XML editors
 +
* empty inline tags
 +
 
 +
All these flaws present a particular challenge to the localization process, especially since
 +
some of the aformentioned errors seem to get into the code in an uncontrolled fashion.
 +
 
 +
Cleaning up the help source must therefore be followed by the introduction of
 +
a process that ensures that such flaws do not make it into the content any more.
 +
A normalization process should make sure that, before changes to help source files
 +
are committed to the repository, the format of the source follows certain rules that
 +
are to be defined, cleaning up the source before a commit.
  
==Project Owner==
 
[mailto:fpe@openoffice.org Frank Peters]
 
  
 
==Issues==
 
==Issues==
* A nice overview over the [[Help Standardisation issues]] from David King is available
 
  
 +
* Modify the export filter so that XML elements are *not* indented<br><code><xsl:output method="xml" indent="no" omit-xml-declaration="no"  /></code>
 +
* Modify the export filter so that the image size attribute is no longer exported
 +
* Use the l10n attribute of paragraphs to mark up l10n irrelevant changes (like fixing typos)
  
 
==Status==
 
==Status==
* Proposed
 
  
==Resources==
 
  
 +
==Resources==
 +
* A nice overview over the [[Help Standardisation issues]] from David King is available.
  
 
{{PDL1}}
 
{{PDL1}}
 
[[Category: Documentation/Dashboard]]
 
[[Category: Documentation/Dashboard]]

Latest revision as of 10:08, 30 June 2018

Editing.png This page is in a DRAFT stage.


Project Help Content Cleanup

Owner: Frank Peters
Status: Proposed

The Help Content Cleanup Project

Summary

This project looks into cleaning up the content of the help as available in the helpcontent2 source code module.

Currently, the help content includes numerous formatting flaws, such as

  • inconsistent usage of span elements
  • inconsistent usage of image size attributes
  • multiple insignificant spaces introduced by formatting XML editors
  • empty inline tags

All these flaws present a particular challenge to the localization process, especially since some of the aformentioned errors seem to get into the code in an uncontrolled fashion.

Cleaning up the help source must therefore be followed by the introduction of a process that ensures that such flaws do not make it into the content any more. A normalization process should make sure that, before changes to help source files are committed to the repository, the format of the source follows certain rules that are to be defined, cleaning up the source before a commit.


Issues

  • Modify the export filter so that XML elements are *not* indented
    <xsl:output method="xml" indent="no" omit-xml-declaration="no" />
  • Modify the export filter so that the image size attribute is no longer exported
  • Use the l10n attribute of paragraphs to mark up l10n irrelevant changes (like fixing typos)

Status

Resources

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools