Feature changed by: Lukas Ocilka (locilka) Feature #305551, revision 20 Title: [Beta5] Document YaST RELAX NG Schema openSUSE-11.2: Rejected by Christoph Thiel (cthiel1) reject date: 2009-07-16 16:26:24 reject reason: out of resources for 11.2. Priority Requester: Desirable Projectmanager: Important - openSUSE-11.3: Candidate + openSUSE-11.3: Done Priority Requester: Desirable Projectmanager: Mandatory Requested by: Thomas Schraitle (thomas-schraitle) Partner organization: openSUSE.org Description: According to bnc#455994 (comment #17) Lukas Ocilka suggested to create a FATE entry for this purpose. Background: The YaST DTD for /etc/YaST2/firstboot.xml and the like is outdated and lead to invalid XML files. The DTD is/was rewritten as a RELAX NG Schema but elements, attributes, and attribute values are not documented yet. Business case (Partner benefit): openSUSE.org: * Documented RNG schema supports XML editors in showing tool tips during the writing of a XML file. * WIth the help of XSLT a summary can be created automatically.

reduces costs

Discussion: #1: Lukas Ocilka (locilka) (2009-01-16 16:32:28) The XML format of a control file is currently documented at http://forgeftp.novell.com/yast/doc/SL11.1/tdg/inst_in_general_chap.html (generated from manually written docbook file) nevertheless this means that it has to be done at two places at once: the RELAX NG schema and its documentation itself. Having the documentation source insite the RELAX NG schema would halp to keep the documentation in sync. #5: Thomas Schraitle (thomas-schraitle) (2009-09-09 08:54:54) Just for the record: See a documented example of a RELAX NG schema in http://gitorious.org/kiwi/kiwi/blobs/master/modules/KIWISchema.rnc (This is the work that I've done with Marcus.) + #7: Lukas Ocilka (locilka) (2010-02-22 17:56:39) + Documentation has been added to RNC file and it's properly atteched to + generated RNG file. Some parts are still missing though, some might not + be described enough - there is always some'can be done better'. So, + please, file a bugreport if you find such issue. -- openSUSE Feature: https://features.opensuse.org/305551