[Openstack-docs] Do we want hyphenation?

Anne Gentle anne at openstack.org
Mon Jul 14 14:20:59 UTC 2014


Hi all,
With this patch: https://review.openstack.org/#/c/106245/ we can get rid of
the "SEVERE" hyphenation error sometimes reported by the maven plugin,
tracked with this bug [1].

There are some possible consequences, though, that I wanted to bring to
this list to make sure we've covered the bases.

Once we update the pom.xml files with this change, all para text will be
hyphenated. It doesn't result in any real page count savings (I just tested
with a few guides over 100 pages, and only saw a one-page count drop). It
does get rid of the error.

The hyphenation quality for English seems high enough to me.

The hyphenation algorithms for English are licensed just fine for our use.

When you use the same pom.xml to build a guide that's in another languages,
the hyphenation algorithms may not exist. I think that's probably fine. The
hyphenation file that does exist may not be super well tested, so I'm not
sure if the quality of the hyphenation will be great for other languages.
Is that acceptable?

Any other input or considerations?

Thanks,
Anne

1. https://bugs.launchpad.net/openstack-manuals/+bug/1273122
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140714/e696bca2/attachment.html>


More information about the Openstack-docs mailing list