Re: [docbook-tc] First cut at DocBook spec

[Norman Walsh <ndw@nwalsh.com>]

Nancy Harrison <nharrison@infobridge-solutions.com> writes:
> 1. Dick is right

Oddly, Dick's comments never came to me, but I'm glad they're quoted here.

> On Thu, Apr 24, 2014 at 6:11 PM, Richard Hamilton <hamilton@xmlpress.net> wrote:
>     1) You've got some un-resolved macros (e.g., {TC name | membership of OASIS}
>     {short name}, etc.)

Right.

>     2) 1.1 Terminology: are key words always italicized? If so, I would change the
>     last sentence to read something like: When used as key words, these words are
>     always italicized. Any instances that are not in italics are not to be
>     interpreted as key words. Note that for reasons of style, these words are not
>     capitalized in this document.

It's best to avoid using the words when they aren't meant. I'm just
going to delete the "reasons of style" sentence.

>     3) 3. Identifying DocBook Documents and Schemas: in the second paragraph,
>     should the second instance of the word "can" be replaced with a key word?
>     Possibly "should"?

Works for me.

>     4) A. The DocBook Media Type, Security considerations: Is this "should" a key
>     word? Or is this a non-normative section, anyway, since it's an appendix?

I'll reword it.

>     5) A. The DocBook Media Type, Applications which use this media type: remove
>     the comma after World Wide Web.

Done.

>     6) B. Acknowledgements: I'm guessing here, but I'll bet Steve Cogorno has a
>     new affiliation (does Sun Micro exist anymore?) and I'm pretty sure Nancy
>     Harrison also has a new affiliation (or perhaps is an Individual member).

Well. I'm not sure what to do about that. For departed members, it
doesn't seem unreasonable to leave their historical affiliations, but
maybe the thing to do is simply remove them.
>
                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | To create a little flower is the
http://www.oasis-open.org/docbook/ | labour of ages.-- Blake
Chair, DocBook Technical Committee |

Attachment: signature.asc
Description: PGP signature