Red Hat Bugzilla – Bug 984772
Bug: Chapter level topic titles do not override title specified in CSP maps.
Last modified: 2013-07-15 20:17:42 EDT
Not sure which component this pertains to.
I noticed that a section level title (which is also a topic) had the correct title in the topic properties but had some extra characters in the CSP Map entry. Tested as follows:
1. Edited Content Spec 20420 in the CCMS UI
2. Used the following Chapter and Topic level content:
Chapter: Setting up an annotations project 
3. Added an a to the ends of both topic titles and saved in the CCMS UI:
Chapter: Setting up an annotations projecta 
4. Waiting for docbuilder to refresh and viewed results:
1. Setting up an annotations projecta
So it looks like if we add new names in the CSP Map for normal topics, the DocBuilder overrides this with the name provided in the Topic Properties. If we do the same for Chapter level (and assuming Section and Part level topics as well, although I have not tested on them), it used the incorrect name from the CSP map and disregards the Topic Properties title.
Not sure if this is intentional to allow quick and easy chapter, section and part name changes or if it is a bug.
This was intentional, since we came up with multiple cases where the two may not align. The other part to remember is that you are only using the content of the topic as the front matter content, and not the actual topic itself as a whole. So the chapter title will always come from the spec, as it always has done in previous version.
There is an option (--strict-level-titles) in the csprocessor push/create/validate commands to ensure that the titles match, otherwise you'll notice in the push/create/validate logs that there is a warning that the titles don't match.