Plan for alternative Open Standard text for Schematron
Rick Jelliffe <[email protected]> Mon, 2 Aug 2021 17:03:48 +1000
| Newsgroups | gmane.text.xml.devel,gmane.text.xml.schematron |
|---|---|
| Message-ID | <CADUdYQUSFyLrt3TDL1+DAfLNRUWsK8=c=mJERY_i1z+kOJu6AA@mail.gmail.com> |
--0000000000006b9f4305c88e2c84
Content-Type: text/plain; charset="UTF-8"
Schematron now does not have an Open Standard text for it. I have a plan
that I would appreciate help with.
*Background:*
Many of you may be aware that ISO decided not to make the new 2020 edition
of the ISO Schematron standard available for free as PDFs on their
publically-available specifications website. Because the new text was not
simultanously maintained by a separate standards body, it did not meet
their criteria.
It is their right to decide that. But it does go against what I thought was
the deal with all DSDL specifications.
The galling thing is that they have also unilaterally token down the free
PDFs of previous editions (2006 and 2016.) 2016 specifies the QLB for
XSLT2, 2020 specifies the QLB for XSLT 3. It looks like they have also
taken down the standards for the other parts of DSDL other than RELAX NG,
which effectively kills them.
So now Schematron, the technology, no longer *has* an Open Standard, the
documentation.
The schemas for Schematron are still freely distributable, by their purpose
and nature. The Open Source software is still Open Source.
N.b. I encourage the members of ISO JTC1SC34 to remonstrate with the ISO
Secretariat in the strongest terms. Please do not take "This is the rules"
as any kind of answer: when rules cause a problem, you don't just stop with
them, you start working out a solution. The obvious compromise is simply to
restore the 2016 specification (and the n-1 versions of the other
disappeared DSDL specs) back onto the ISO Publically Available
Specifications.
*Plan:*
I want to put out an alternative description of exactly the same technology
as ISO Schematron describes, with no common wording, and make it available
as an Open Standard.
I am updating the Schematron.com website to move from WordPress to
PageSeeder, perhaps this week, which provides collaborative editing
facilities on a web interface. It gives us a chance to explain Schematon
in hypertext with code or examples, not the particular limitations of
formal standards.
The intent is not that ISO Schematron should lapse or not be maintained: it
is good for adoption. But as ISO will not (they would say, cannot) support
the needs of small, non-corporate, speculative and Open Source developers,
there is no reason for us to sit around crying.
I hope to switch to the new site later this week. I have all the existing
site moved over now. PageSeeder is a 20-year mature system, based on XLinks
and topics, actually. Nick Carr of Allette Systems has very kindly provided
the license free, and his staff made a look-alike for the current site.
PageSeeder is like a cross between WordPress and GitHub. It has very
responsive QUASIWYG editing, revision tracking and display, threaded
comments available most everywhere, TOC and topic-link generation.
Most interestingly, it has, I think, the most tightly integrated Schematron
validation built into the page editors: very, very slick and pretty. (The
Schematron is there to let authors know if some part of the page won't
convert to whatever external XML has been registered for that site. We
wouldn't be using that functionality.)
*Help Wanted*
So I would like for the Open Standard Schematron spec to have good input
from the community. My health and concentration is pretty good at the
moment (ah the benefits of lockdown and unemployment!)
This could be anything:
- You have some pet idea about how to organize a good Open Standard.
- I always favour minimalism and code in standards. Particularly
because I am not the least prolix writer.
- You have some diagrams or cartoons, or ideas for them.
- One thing I am quite proud of was making those hyperlinked diagrams
for the XSD datatype hierarchy.
https://www.w3.org/TR/xmlschema-2/#built-in-datatypes
- You have some text already that you think explains some things really
well, that I can use.
- This might include outlines in slides
- You are happy to look over drafts online and make comments.
- Commenting will be open to the public without loging
- You want to participate as an actual writer of some sections, or as
sub-editor, or as editor.
- This would involve getting a login. The PageSeeder editor is pretty
obvious.
The first step, I think, is to come up with a TOC or organization. I think
one page per element, each with the DTD line hyperlinked, and any
Schematron schema assertions that apply.
(Does anyone know of software that creates a hyperlinked set of pages for a
DTD or XSD or RELAX NG schema?)
Regards
Rick Jelliffe
--0000000000006b9f4305c88e2c84
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
<div dir=3D"ltr"><div>Schematron now does not have an Open Standard text fo=
r it.=C2=A0 I have a plan that I would appreciate help with. <br></div><div=
><br></div><div><b>Background:</b><br></div><div><br></div><div>Many of you=
may be aware that ISO decided not to make the new 2020 edition of the ISO =
Schematron standard available for free as PDFs on their publically-availabl=
e specifications website. Because the new text was not simultanously mainta=
ined by a separate standards body, it did not meet their criteria.</div><di=
v><br></div><div>It is their right to decide that. But it does go against w=
hat I thought was the deal with all DSDL specifications.</div><div><br></di=
v><div>The galling thing is that they have also unilaterally token down the=
free PDFs of previous editions (2006 and 2016.)=C2=A0 2016 specifies the Q=
LB for XSLT2, 2020 specifies the QLB for XSLT 3.=C2=A0 It looks like they h=
ave also taken down the standards for the other parts of DSDL other than RE=
LAX NG, which effectively kills them.=C2=A0 <br></div><div><br></div><div>S=
o now Schematron, the technology, no longer <i>has</i> an Open Standard, th=
e documentation.=C2=A0 <br></div><div><div><br></div><div>The schemas for S=
chematron are still freely distributable, by their purpose and nature. The =
Open Source software is still Open Source.<br></div><div><br></div></div><d=
iv>N.b.=C2=A0 I encourage the members of ISO JTC1SC34 to remonstrate with t=
he ISO Secretariat in the strongest terms. Please do not take "This is=
the rules" as any kind of answer: when rules cause a problem, you don=
't just stop with them, you start working out a solution. The obvious c=
ompromise is simply to restore the 2016 specification (and the n-1 versions=
of the other disappeared DSDL specs) back onto the ISO Publically Availabl=
e Specifications. <br></div><div><br></div><div><b>Plan:</b></div><div>I wa=
nt to put out an alternative description of exactly the same technology as =
ISO Schematron describes, with no common wording, and make it available as =
an Open Standard.=C2=A0 <br></div><div><br></div><div>I am updating the Sch=
ematron.com website to move from WordPress to PageSeeder, perhaps this week=
, which provides collaborative editing facilities on a web interface.=C2=A0=
It gives us a chance to explain Schematon in hypertext with code or exampl=
es, not the particular limitations of formal standards.</div><div><br></div=
><div>The intent is not that ISO Schematron should lapse or not be maintain=
ed: it is good for adoption. But as ISO will not (they would say, cannot) s=
upport the needs of small, non-corporate, speculative and Open Source devel=
opers, there is no reason for us to sit around crying. <br></div><div><br><=
/div><div>I hope to switch to the new site later this week. I have all the =
existing site moved over now. PageSeeder is a 20-year mature system, based =
on XLinks and topics, actually. Nick Carr of Allette Systems has very kindl=
y provided the license free, and his staff made a look-alike for the curren=
t site.=C2=A0 <br></div><div><br></div><div>PageSeeder is like a cross betw=
een WordPress and GitHub.=C2=A0 It has very responsive QUASIWYG editing, re=
vision tracking and display, threaded comments available most everywhere, T=
OC and topic-link generation.=C2=A0 <br></div><div><br></div><div>Most inte=
restingly, it has, I think, the most tightly integrated Schematron validati=
on built into the page editors: very, very slick and pretty.=C2=A0 (The Sch=
ematron is there to let authors know if some part of the page won't con=
vert to whatever external XML has been registered for that site.=C2=A0 We w=
ouldn't be using that functionality.)</div><div><br></div><div><b>Help =
Wanted<br></b></div><div>So I would like for the Open Standard Schematron s=
pec to have good input from the community. My health and concentration is p=
retty good at the moment (ah the benefits of lockdown and unemployment!)<br=
></div><div><br></div><div>This could be anything: <br></div><div><ul><li>Y=
ou have some pet idea about how to organize a good Open Standard.</li><ul><=
li>=C2=A0I always favour minimalism and code in standards. Particularly bec=
ause I am not the least prolix writer.</li></ul><li>You have some diagrams =
or cartoons, or ideas for them.=C2=A0</li><ul><li>One thing I am quite prou=
d of was making those hyperlinked diagrams for the XSD datatype hierarchy. =
<a href=3D"https://www.w3.org/TR/xmlschema-2/#built-in-datatypes">https://w=
ww.w3.org/TR/xmlschema-2/#built-in-datatypes</a></li></ul><li>You have some=
text already that you think explains some things really well, that I can u=
se.</li><ul><li>This might include outlines in slides<br></li></ul><li>You =
are happy to look over drafts online and make comments.</li><ul><li>Comment=
ing will be open to the public without loging<br></li></ul><li>You want to =
participate as an actual writer of some sections, or as sub-editor, or as e=
ditor.</li><ul><li>This would involve getting a login. The PageSeeder edito=
r is pretty obvious. <br></li></ul></ul><div>The first step, I think, is to=
come up with a TOC or organization. I think one page per element, each wit=
h the DTD line hyperlinked, and any Schematron schema assertions that apply=
. <br><br>(Does anyone know of software that creates a hyperlinked set of p=
ages for a DTD or XSD or RELAX NG schema?)<br></div><div><br></div><div>Reg=
ards</div><div>Rick Jelliffe<br></div></div><div><br></div><div> <br></div>=
<div><br></div></div>
--0000000000006b9f4305c88e2c84--