Re: [docbook] Current version of DocBook and relationship between OASIS / Doc

2017-11-06 Thread Eitan Adler 
Thank you all. Learned a lot.
I'll file a ticket asking for the zip distribution. Not required, but
will make life slightly easier.

On 6 November 2017 at 07:08, Dave Pawson  wrote:
> I stand  corrected.
>
> Dave
>
> On 6 November 2017 at 14:48, Jirka Kosek  wrote:
>> On 6.11.2017 15:39, Dave Pawson wrote:
>>> One small (0bvious?) addition:
>>>5.1 is being developed outside of Oasis, prior to submission to Oasis
>>> as a candidate standard.
>>
>> No, all schema changes are discussed and decided by DocBook TC. But
>> because OASIS doesn't provide good technical infrastructure new
>> requirements and beta version of schemas are managed on GitHub. So it
>> seems that only final committee specification or standard is published
>> by OASIS.
>>
>> Jirka
>>
>> --
>> --
>>   Jirka Kosek  e-mail: ji...@kosek.cz  http://xmlguru.cz
>> --
>>  Professional XML and Web consulting and training services
>> DocBook/DITA customization, custom XSLT/XSL-FO document processing
>> --
>> Bringing you XML Prague conferencehttp://xmlprague.cz
>> --
>>
>
>
>
> --
> Dave Pawson
> XSLT XSL-FO FAQ.
> Docbook FAQ.
> http://www.dpawson.co.uk



-- 
Eitan Adler

-
To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-h...@lists.oasis-open.org

Re: [docbook] Current version of DocBook and relationship between OASIS / Doc

2017-11-06 Thread Dave Pawson 
I stand  corrected.

Dave

On 6 November 2017 at 14:48, Jirka Kosek  wrote:
> On 6.11.2017 15:39, Dave Pawson wrote:
>> One small (0bvious?) addition:
>>5.1 is being developed outside of Oasis, prior to submission to Oasis
>> as a candidate standard.
>
> No, all schema changes are discussed and decided by DocBook TC. But
> because OASIS doesn't provide good technical infrastructure new
> requirements and beta version of schemas are managed on GitHub. So it
> seems that only final committee specification or standard is published
> by OASIS.
>
> Jirka
>
> --
> --
>   Jirka Kosek  e-mail: ji...@kosek.cz  http://xmlguru.cz
> --
>  Professional XML and Web consulting and training services
> DocBook/DITA customization, custom XSLT/XSL-FO document processing
> --
> Bringing you XML Prague conferencehttp://xmlprague.cz
> --
>



-- 
Dave Pawson
XSLT XSL-FO FAQ.
Docbook FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-h...@lists.oasis-open.org

Re: [docbook] Current version of DocBook and relationship between OASIS / Doc

2017-11-06 Thread Jirka Kosek 
On 6.11.2017 15:39, Dave Pawson wrote:
> One small (0bvious?) addition:
>5.1 is being developed outside of Oasis, prior to submission to Oasis
> as a candidate standard.

No, all schema changes are discussed and decided by DocBook TC. But
because OASIS doesn't provide good technical infrastructure new
requirements and beta version of schemas are managed on GitHub. So it
seems that only final committee specification or standard is published
by OASIS.

Jirka

-- 
--
  Jirka Kosek  e-mail: ji...@kosek.cz  http://xmlguru.cz
--
 Professional XML and Web consulting and training services
DocBook/DITA customization, custom XSLT/XSL-FO document processing
--
Bringing you XML Prague conferencehttp://xmlprague.cz
--



signature.asc
Description: OpenPGP digital signature

Re: [docbook] Current version of DocBook and relationship between OASIS / Doc

2017-11-06 Thread Dave Pawson 
Well explained Jirka...
   But I have to agree, it is all rather confusing when set out like that :-)

One small (0bvious?) addition:
   5.1 is being developed outside of Oasis, prior to submission to Oasis
as a candidate standard.

HTH

On 6 November 2017 at 14:32, Jirka Kosek  wrote:
> On 5.11.2017 20:48, Eitan Adler wrote:
>> What is the relationship between OASIS and DocBook? Both from an
>> organizational and specification perspective.
>
> Hi,
>
> I will try to explain, but others feel free to add more information.
>
> OASIS (https://www.oasis-open.org/) is organization that develops
> standards. DocBook schema is developed by DocBook Technical Committee
> (https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook)
> following OASIS process
> (https://www.oasis-open.org/policies-guidelines/tc-process-2017-05-26).
>
> DocBook TC develops only schema for DocBook. There are other important
> assets like stylesheets or documentation -- these are developed
> independently from OASIS, usually by few volunteers on open-source basis.
>
>> What is prompting this question:
>> - http://docs.oasis-open.org/docbook/docbook/v5.1/os/docbook-v5.1-os.html
>> claims that 5.1 is a OASIS Standard
>
> That's true
>
>> - http://docbook.org/xml/5.1/ appears to be exist, but lacks
>> docbook-5.1.zip and does not say "There is a specification for this
>> release."
>> - http://docbook.org/xml/5.0/ has the zip file and specification sentence
>
> I agree that difference might be confusing but it's not intentional.
> Most likely change is caused by change in build system used and people
> involved in the process.
>
> If you miss ZIP distribution and link to specification please fill issue
> for this at: https://github.com/docbook/docbook.org/issues
>
>> - http://www.oasis-open.org/docbook/xml/ shows 5.0 but not 5.1
>> - http://www.oasis-open.org/docbook/xml/5.0/index.xml says "This
>> version has not been released yet."
>> - http://www.oasis-open.org/docbook/xml/5.0/index.xml says has an
>> ancient rcsdate and references alpha1 even though
>> http://www.oasis-open.org/docbook/xml/ lists newer versions (betas and
>> releases)
>
> Umm, well. Outdated info on oasis-open.org is hard to explain to
> outsider. The short story is that process for updating these pages is
> not very convenient and thus these pages are outdated. I suggest using
>
> http://docbook.org/xml/
>
> instead. docbook.org domain is under control of DocBook community.
> Folders at http://www.oasis-open.org/docbook/xml/ should be mirror of
> http://docbook.org/xml/ -- but this setup never worked for reasons
> explained above.
>
> Hope this helps little bit,
>
> Jirka
>
>
> --
> --
>   Jirka Kosek  e-mail: ji...@kosek.cz  http://xmlguru.cz
> --
>  Professional XML and Web consulting and training services
> DocBook/DITA customization, custom XSLT/XSL-FO document processing
> --
> Bringing you XML Prague conferencehttp://xmlprague.cz
> --
>



-- 
Dave Pawson
XSLT XSL-FO FAQ.
Docbook FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-h...@lists.oasis-open.org

Re: [docbook] Current version of DocBook and relationship between OASIS / Doc

2017-11-06 Thread Jirka Kosek 
On 5.11.2017 20:48, Eitan Adler wrote:
> What is the relationship between OASIS and DocBook? Both from an
> organizational and specification perspective.

Hi,

I will try to explain, but others feel free to add more information.

OASIS (https://www.oasis-open.org/) is organization that develops
standards. DocBook schema is developed by DocBook Technical Committee
(https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook)
following OASIS process
(https://www.oasis-open.org/policies-guidelines/tc-process-2017-05-26).

DocBook TC develops only schema for DocBook. There are other important
assets like stylesheets or documentation -- these are developed
independently from OASIS, usually by few volunteers on open-source basis.

> What is prompting this question:
> - http://docs.oasis-open.org/docbook/docbook/v5.1/os/docbook-v5.1-os.html
> claims that 5.1 is a OASIS Standard

That's true

> - http://docbook.org/xml/5.1/ appears to be exist, but lacks
> docbook-5.1.zip and does not say "There is a specification for this
> release."
> - http://docbook.org/xml/5.0/ has the zip file and specification sentence

I agree that difference might be confusing but it's not intentional.
Most likely change is caused by change in build system used and people
involved in the process.

If you miss ZIP distribution and link to specification please fill issue
for this at: https://github.com/docbook/docbook.org/issues

> - http://www.oasis-open.org/docbook/xml/ shows 5.0 but not 5.1
> - http://www.oasis-open.org/docbook/xml/5.0/index.xml says "This
> version has not been released yet."
> - http://www.oasis-open.org/docbook/xml/5.0/index.xml says has an
> ancient rcsdate and references alpha1 even though
> http://www.oasis-open.org/docbook/xml/ lists newer versions (betas and
> releases)

Umm, well. Outdated info on oasis-open.org is hard to explain to
outsider. The short story is that process for updating these pages is
not very convenient and thus these pages are outdated. I suggest using

http://docbook.org/xml/

instead. docbook.org domain is under control of DocBook community.
Folders at http://www.oasis-open.org/docbook/xml/ should be mirror of
http://docbook.org/xml/ -- but this setup never worked for reasons
explained above.

Hope this helps little bit,

Jirka


-- 
--
  Jirka Kosek  e-mail: ji...@kosek.cz  http://xmlguru.cz
--
 Professional XML and Web consulting and training services
DocBook/DITA customization, custom XSLT/XSL-FO document processing
--
Bringing you XML Prague conferencehttp://xmlprague.cz
--



signature.asc
Description: OpenPGP digital signature