Open Stack

We could add a schematron rule to catch when there's a link from an
external to interal stuff. We should also use the schematron rules
during build-time validation (not just in Oxygen as we do now).

David

On 07/31/2012 09:41 AM, Anne Gentle wrote:
> Hi all -
> It's fixed with this patch.
> 
> https://review.openstack.org/10605
> 
> As I explain in the commit message, "Unfortunately the actual
> validation problem is often masked
> by a "fake" validation problem with link linkend= internal
> cross references. Had to remove two linkend internal cross
> references to enable troubleshooting."
> 
> I've logged a bug against the Maven build tool to request a fix to the
> link linkend cross reference problem.
> https://bugs.launchpad.net/openstack-manuals/+bug/1031374 If someone
> else can confirm it that would be helpful.
> 
> I'll also investigate gating with the CI team - and notifications from
> Jenkins when a build breaks. We should be catching these at review
> time as well.
> 
> Thanks,
> Anne
> 
> On Tue, Jul 31, 2012 at 8:15 AM, Ying Chun Guo <guoyingc at cn.ibm.com> wrote:
>> Not sure how it is happened.
>> See here: https://jenkins.openstack.org/view/Openstack-manuals/
>> There are several manual projects with build failures.
>>
>> Regards
>> Ying Chun Guo (Daisy)
>> China Standards and Open Source Team
>> Emerging Technology Institute (ETI)
>> IBM China Development Lab
>> Tel:(86-10)82453491
>> Email: guoyingc at cn.ibm.com
>> Address: 1F Tower B, Diamond Building 19 Zhongguancun Software Park,
>> 8 Dongbeiwang West Road, Haidian District, Beijing, P.R.C.100193
>>
>> John Garbutt <John.Garbutt at citrix.com> wrote on 07/31/2012 08:51:56 PM:
>>
>>> John Garbutt <John.Garbutt at citrix.com>
>>> 07/31/2012 08:51 PM
>>>
>>> To
>>>
>>> Lorin Hochstein <lorin at nimbisservices.com>,
>>>
>>> cc
>>>
>>> "openstack-ci-admins at lists.launchpad.net" <openstack-ci-
>>> admins at lists.launchpad.net>, "openstack-docs at lists.openstack.org"
>>> <openstack-docs at lists.openstack.org>
>>
>>
>>>
>>> Subject
>>>
>>> Re: [Openstack-docs] Build Issues
>>>
>>> OK, no problem. I just assumed it was my setup that was broken.
>>>
>>> Just wondered, any chance the CI team can add a gating job to stop this
>>> issue?
>>> I think we have that in nova now for the developer docs?
>>>
>>> Cheers,
>>> John
>>>
>>> From: Lorin Hochstein [mailto:lorin at nimbisservices.com]
>>> Sent: Tuesday, July 31, 2012 1:46 PM
>>> To: John Garbutt
>>> Cc: openstack-docs at lists.openstack.org
>>> Subject: Re: [Openstack-docs] Build Issues
>>>
>>> John:
>>>
>>> I just tried, I can't build it either. When that happens, go ahead
>>> and log a bug. I just did that here: https://bugs.launchpad.net/
>>> openstack-manuals/+bug/1031327
>>>
>>> Take care,
>>>
>>> Lorin
>>> --
>>> Lorin Hochstein
>>> Lead Architect - Cloud Services
>>> Nimbis Services, Inc.
>>> www.nimbisservices.com
>>>
>>>
>>
>>>
>>> On Jul 31, 2012, at 6:51 AM, John Garbutt <John.Garbutt at citrix.com> wrote:
>>>
>>
>>> Hi,
>>>
>>> I have previously built the Docs, and all went well.
>>> However I updated to the latest trunk and I key a validation error,
>>> even before I make any changes.
>>> Has anyone else seen this?
>>>
>>> Cheers,
>>> John
>>>
>>> The error:
>>> :~/openstack/openstack-manuals/doc/src/docbkx/openstack-compute-
>>> admin$ mvn clean generate-sources [INFO] Scanning for projects...
>>> [INFO]
>>> [INFO]
>>> ------------------------------------------------------------------------
>>> [INFO] Building OpenStack Guides 1.0.0-SNAPSHOT [INFO]
>>> ------------------------------------------------------------------------
>>> [INFO]
>>> [INFO] --- maven-clean-plugin:2.3:clean (default-clean) @ openstack-
>>> guide --- [INFO] Deleting file set: /home/johngar/openstack/
>>> openstack-manuals/doc/src/docbkx/openstack-compute-admin/target
>>> (included: [**], excluded: []) [INFO] [INFO] --- clouddocs-maven-
>>> plugin:1.3.1:generate-pdf (goal1) @ openstack-guide --- [INFO]
>>> Processing input file: bk-compute-adminguide.xml
>>> Message: Entering xproc pipeline
>>> Message: Validating post-xinclude
>>> 31-Jul-2012 10:16:30 com.xmlcalabash.util.DefaultXProcMessageListener info
>>> INFO: 56:35:
>>>                                        @@@@@@@@@@@@@@@@@@@@@@
>>>                                        !!!VALIDATION ERROR!!!
>>>                                        !!!!!!!!!!!!!!!!!!!!!!
>>>                                        <c:errors xmlns:c="http://
>>> www.w3.org/ns/xproc-step">
>>>   <c:error line="9312" column="11">org.xml.sax.SAXParseException;
>>> systemId:
>>> file:///home/johngar/openstack/openstack-manuals/doc/src/docbkx/
>>> openstack-compute-admin/bk-compute-adminguide.xml; lineNumber: 9312;
>>> columnNumber: 11; element "para" not allowed here; expected the
>>> element end-tag, text or element "abbrev", "accel", "acronym",
>>> "address", "alt", "anchor", "annotation", "application", "author",
>>> "bibliolist", "biblioref", "blockquote", "bridgehead",
>>> "calloutlist", "caution", "citation", "citebiblioid",
>>> "citerefentry", "citetitle", "classname", "classsynopsis",
>>> "cmdsynopsis", "code", "command", "computeroutput", "constant",
>>> "constraintdef", "constructorsynopsis", "coref", "database", "date",
>>> "destructorsynopsis", "editor", "email", "emphasis", "envar",
>>> "epigraph", "equation", "errorcode", "errorname", "errortext",
>>> "errortype", "example", "exceptionname", "fieldsynopsis", "figure",
>>> "filename", "firstterm", "footnote", "footnoteref", "foreignphrase",
>>> "funcsynopsis", "function", "glosslist", "glossterm", "guibutton",
>>> "guiicon", "guilabel", "guimenu", "guimenuitem", "guisubmenu",
>>> "hardware", "important", "indexterm", "informalequation",
>>> "informalexample", "informalfigure", "informaltable", "initializer",
>>> "inlineequation", "inlinemediaobject", "interfacename",
>>> "itemizedlist", "jobtitle", "keycap", "keycode", "keycombo",
>>> "keysym", "link", "literal", "literallayout", "markup",
>>> "mediaobject", "menuchoice", "methodname", "methodsynopsis",
>>> "modifier", "mousebutton", "msgset", "nonterminal", "note", "olink",
>>> "ooclass", "ooexception", "oointerface", "option", "optional",
>>> "orderedlist", "org", "orgname", "package", "parameter", "person",
>>> "personname", "phrase", "procedure", "productionset", "productname",
>>> "productnumber", "programlisting", "programlistingco", "prompt",
>>> "property", "qandaset", "quote", "remark", "replaceable",
>>> "returnvalue", "revhistory", "screen", "screenco", "screenshot",
>>> "segmentedlist", "shortcut", "sidebar", "simplelist", "subscript",
>>> "superscript", "symbol", "synopsis", "systemitem", "table", "tag",
>>> "task", "termdef", "tip", "token", "trademark", "type", "uri",
>>> "userinput", "variablelist", "varname", "warning", "wordasword",
>>> "xi:include" or "xref"</c:error> </c:errors>
>>>                                        !!!!!!!!!!!!!!!!!!!!!!
>>>                                        !!!VALIDATION ERROR!!!
>>>                                        @@@@@@@@@@@@@@@@@@@@@@
>>>
>>> 31-Jul-2012 10:16:30 com.xmlcalabash.util.DefaultXProcMessageListener
>>> error
>>> SEVERE: Processing terminated by xsl:message at line -1 in
>>> 31-Jul-2012 10:16:30 com.xmlcalabash.util.DefaultXProcMessageListener
>>> error
>>> SEVERE: Processing terminated by xsl:message at line -1 in [INFO]
>>> ------------------------------------------------------------------------
>>> [INFO] BUILD FAILURE
>>> [INFO]
>>> ------------------------------------------------------------------------
>>> [INFO] Total time: 5.655s
>>> [INFO] Finished at: Tue Jul 31 10:16:30 BST 2012 [INFO] Final
>>> Memory: 16M/196M [INFO]
>>> ------------------------------------------------------------------------
>>> [ERROR] Failed to execute goal com.rackspace.cloud.api:clouddocs-
>>> maven-plugin:1.3.1:generate-pdf (goal1) on project openstack-guide:
>>> Execution goal1 of goal com.rackspace.cloud.api:clouddocs-maven-
>>> plugin:1.3.1:generate-pdf failed:
>>> net.sf.saxon.s9api.SaxonApiException: Processing terminated by
>>> xsl:message at line -1 in -> [Help 1
>>>
>>> _______________________________________________
>>> Openstack-docs mailing list
>>> Openstack-docs at lists.openstack.org
>>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>>  _______________________________________________
>>> Openstack-docs mailing list
>>> Openstack-docs at lists.openstack.org
>>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>