- From: Liam R. E. Quin <liam@fromoldbooks.org>
- Date: Wed, 30 Oct 2024 18:01:08 -0400
- To: Norm Tovey-Walsh <norm@saxonica.com>
- Cc: "public-xslt-40@w3.org" <public-xslt-40@w3.org>
On Wed, 2024-10-30 at 16:17 +0000, Norm Tovey-Walsh wrote: > > > I think it’s a language specification for implementors. > > (Yes, language users are going to refer to it. Especially in the > short-to-medium term when books and articles and tutorials haven’t > caught up with 4.0 yet, but we aren’t writing documentation for > users. We’re trying to write documentation that users can understand, > of course, but it isn’t a user guide.) It is also a document for people writing articles, books, tutorials, courses, who are often not implementers. And for people writing other specs that might refer to it (as e.g. SPARQL does for the 2.0 and maybe 3.0 documents). In the XSLT courses i teach, i try to get people to the point where they are comfortable reading the specs. We also need to remember that it's not improbable there won't be any books on QT4, nor a whole lot of courses or tutorials. So this is where users will go, and if the docs don't cater to them, there won't be many users. But the good news is the documents are well-written and well-edited, so in fact they are not unwelcoming. liam -- Liam Quin, https://www.delightfulcomputing.com/ Available for XML/Document/Information Architecture/XSLT/ XSL/XQuery/Web/Text Processing/A11Y training, work & consulting. Barefoot Web-slave, antique illustrations: http://www.fromoldbooks.org
Received on Wednesday, 30 October 2024 22:01:13 UTC