Red Hat Bugzilla – Bug 981118
RFE: Provide a way of enabling a standardized Author_Group.xml file
Last modified: 2013-10-17 21:36:48 EDT
Currently, it is necessary to override the Author_Group.xml file every time a book is downloaded with the CSProcessor if the docs team uses a different author_group.xml file to the standard file provided by the CCMS. The override is used, for example, to list the author as "Red Hat Content Services".
If it's possible to provide a switch in the CSP map that docs leads could activate to skip the override that would be very helpful. Similar to the 'bug links =' switch.
Actually there are other ways to implement this. Here are some ideas.
1. Make it CSP-specific. Allow multiple AUTHOR= statements in the front-matter. Alternately, allow a chunk of XML in the front-matter and this would be inserted into the Author Group bit automatically. The second way may be messy.
2. Allow us to specify an Author Group file in the same way that we can specify a Revision History, Feedback, or Legal Notice override.
Actually, more generically, new content specs should probably include a new Author Group and Revision History file by default, in the front-matter. WDYT?
Yeah, 2 was the approach I was thinking of personally, as 1 has the potential to get really messy if have a lot of writers and 2 is more customisable.
As for the other suggestion I can see pros/cons and is probably better suited to its own RFE, but here are some points quickly:
1. If you are importing a book then you more than likely won't want a rev history/author group created when creating the spec.
2. What if you want to just use the defaults? You are then going to have orphan topics created that will never be used.
The above is void if you are just referring to the template though...
Yes I'm only referring to the templates. For importing a book, you wouldn't be using the template, but rather the spec generated by the import tool. In that case, the Author_Group.xml and Revision_History.xml should be imported into topics as well. They are not right now, but I have asked Dan for this RFE in Chopbook. Adding him to the CC of this bug so he can comment.
(In reply to Misty Stanley-Jones from comment #1)
> Actually there are other ways to implement this. Here are some ideas.
> 2. Allow us to specify an Author Group file in the same way that we can
> specify a Revision History, Feedback, or Legal Notice override.
I think option 2 for the reason you mentioned.
*** Bug 1011898 has been marked as a duplicate of this bug. ***
I'm removing this as a blocker for Platform R&D because on further reflection, I think implementing the various missing roles on a per-topic basis where possible and specifying them individually on a book basis where necessary makes better sense.
From a platform point-of-view, bug 1012209 bug 1013433 and bug 1013436 together better provide the functionality missing here.
I think that Book-level credits should be additive to topic-level credits; so for books that seek to override or conceal the dynamically generated Author_Group, supplying a separate Author_Group file or an author_group override in the topic map would still be necessary. That kind of override isn't needed for platform though.
Confirmed that the Author Group topic needs the corresponding tag, and that when assigned to a spec will overwrite the Author_Group.xml file.
However with an author group topic assigned, all the topics lost their fixed url name, and reverted back to something like "TopicID8199.xml".
Confirmed that removing the Author Group metadata element means the topics get their fixed url file names.
That sounds like an issue in the fixed url pass which has nothing to do with this RFE, though we'll still need to find out why it's failing.
Fixed in 1.2-SNAPSHOT build 201310151644
As previously mentioned it was an unrelated server bug that was causing the fixed url pass to fail. I've also updated the builder to add an error message that it failed.
Verified that this now works by deleting the Fixed URL of the Author Group and rebuilding. The links still remained in their human readable form and the Author Groups fixed url was re-created.
Missed an important note about this that came up today. Due to the elements that are allowed in an <authorgroup> there isn't anyway to inject editor or bug links, so custom author groups won't have them included.
Also if an author group is invalid it will be replaced by the default author group and an error will be included in the Compiler Output chapter.