Re: Want to produce for the first time a PR for a Spec - where to find description of the XML-schema of a Spec and about the whole process?

>

On Thu, Sep 28, 2023 at 9:56 AM Michael Kay <mike@saxonica.com> wrote:

> The basic schema (in the form of a DTD) is found in
> qtspecs/schema/xmlspec.dtd, which is further customised by
> qtspecs/schema/xsl-query.dtd. There are comments in these DTDs to help
> explain their usage, but frankly, I wouldn't want to rely entirely on the
> comments; it's much easier to find examples of what you want to do in the
> actual instance documents, and learn by example.
>
> There are some more specialised formats with their own schemas, for
> example grammar.dtd for the BNF grammar (XPath/XQuery plus XSLT patterns),
> and fos.xsd for the function catalog.
>
> The files you will want to edit are typically found in
> qtspecs/specifications/SPECNAME/src/*.xml. For some of the specs the text
> is split into multiple files; if you have difficulty finding the file
> containing the text you want to edit, then a directory search can be useful.
>
> I think most of the process documentation has been deleted because it was
> hopelessly out of date.
>
> There's no documentation specific to git, it is assumed that users are
> familiar with git working methods.
>
> To build the specs, simply type "gradle". That builds the whole thing, I
> don't ever attempt any more specific build targets. The built specs will
> appear in  qtspecs/build/www.
>
> If you have specific questions, don't be afraid to ask. Start with
> something fairly small so we can put you on the right path if you go astray.
>
> Michael Kay
> Saxonica
>
> > On 28 Sep 2023, at 16:55, Dimitre Novatchev <dnovatchev@gmail.com>
> wrote:
> >
> >
> > I have never before produced a PR for a Spec document and need
> guidance/resources about the files that are involved and their
> xml-schema/semantics.
> >
> > Can someone, please, help?
> >
> > Thanks,
> > Dimitre
> >
>
>

-- 
Cheers,
Dimitre Novatchev
---------------------------------------
Truly great madness cannot be achieved without significant intelligence.
---------------------------------------
To invent, you need a good imagination and a pile of junk
-------------------------------------
Never fight an inanimate object
-------------------------------------
To avoid situations in which you might make mistakes may be the
biggest mistake of all
------------------------------------
Quality means doing it right when no one is looking.
-------------------------------------
You've achieved success in your field when you don't know whether what
you're doing is work or play
-------------------------------------
To achieve the impossible dream, try going to sleep.
-------------------------------------
Facts do not cease to exist because they are ignored.
-------------------------------------
Typing monkeys will write all Shakespeare's works in 200yrs.Will they write
all patents, too? :)
-------------------------------------
Sanity is madness put to good use.
-------------------------------------
I finally figured out the only reason to be alive is to enjoy it.