Per ticket 1459 and Council's directive in Victoria, I have re-written the content model section of TD. Please read through both the prologue of * http://jenkins-paderborn.tei-c.org/job/TEIP5-dev/lastSuccessfulBuild/artifac... and its first subsection, * http://jenkins-paderborn.tei-c.org/job/TEIP5-dev/lastSuccessfulBuild/artifac... (they are both quite short: < 800 words of prose and 4 examples total) and let me know what you think. BTW, I note that in each example the link to the bibliography has migrated to the left. While politically I'm OK with that, aesthetically it's awful.
Hi Syd, I have some minor remarks on the rewrite: #DEFCON 1) ":" is missing before the enumeration of the three distinctly different ways of specifying a content model. Do you want to use <list rend="bulleted"> for that? #DEFCONTEI 2) I would change the last sentence of the first paragraph to "as the only content of the content element". Is it necessary to emphasize that <empty> is an empty element? It makes the sentence hard to read. If you decide to keep it, you should also add 'empty' before <textNode> further down for continuity. 3) for consistency reasons I'd delete the "an" in the specification of <alternate> 4) explanation of the second example: is it worth to mention the difference in using the cardinality on <elementRef> or <alternate>? 5) I wonder if there should be a simple example on using <sequence>? <content> <sequence> <elementRef key="ab"/> <elementRef key="cd"/> </sequence> </content> 7) the <anyElement> is not mentioned in the section (resp. the whole chapter) any more. 8) should there be an example using <classRef> OR <macroRef> too? 9) @bibliography on the left: that's only on the paderborn jenkins, see: http://teijenkins.hcmc.uvic.ca/job/TEIP5-dev/lastSuccessfulBuild/artifact/P5... Best wishes, Martina -----Ursprüngliche Nachricht----- Von: tei-council-bounces@lists.tei-c.org [mailto:tei-council-bounces@lists.tei-c.org] Im Auftrag von Syd Bauman Gesendet: Samstag, 20. Jänner 2018 19:37 An: TEI Council Betreff: [tei-council] TD section redo Per ticket 1459 and Council's directive in Victoria, I have re-written the content model section of TD. Please read through both the prologue of * http://jenkins-paderborn.tei-c.org/job/TEIP5-dev/lastSuccessfulBuild/artifac... and its first subsection, * http://jenkins-paderborn.tei-c.org/job/TEIP5-dev/lastSuccessfulBuild/artifac... (they are both quite short: < 800 words of prose and 4 examples total) and let me know what you think. BTW, I note that in each example the link to the bibliography has migrated to the left. While politically I'm OK with that, aesthetically it's awful. -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council PLEASE NOTE: postings to this list are publicly archived
I have some minor remarks on the rewrite:
Thank you, Martina!
#DEFCON
1) ":" is missing before the enumeration of the three distinctly different ways of specifying a content model. Do you want to use <list rend="bulleted"> for that?
The enumeration of the three distinctly different ways of specifying a content model were encoded just as paragraphs, not a list. I'll try a list so we can take a look at it that way, too. Take a look at https://bauman.zapto.org/~syd/temp/4TEICouncil/TD_DEFCON.html and let me know what you think.
#DEFCONTEI
2) ...
Deferred for now.
3) for consistency reasons I'd delete the "an" in the specification of <alternate>
I think both the <desc> for <sequence> and the <desc> for <alternate> are pretty lame. How about: <sequence>: indicates that the constructs referenced by its children form a sequence <alternate>: indicates that the constructs referenced by its children form an alternation
4) explanation of the second example: is it worth to mention the difference in using the cardinality on <elementRef> or <alternate>?
I don't think it can hurt, but I was sort of thinking (at the time) that even what I have is overkill, as this is covered in the Gentle Introduction to XML (at #SG146).
5) I wonder if there should be a simple example on using <sequence>? 8) should there be an example using <classRef> OR <macroRef> too?
Same as above -- how much do we explain the use of content models here, as opposed to just the syntax of PureODD (leaving the explanation of how to use content models to SG)?
7) the <anyElement> is not mentioned in the section (resp. the whole chapter) any more.
Oh dear. I'm not sure what "resp." means, but you're right, the only place that <anyElement> is mentioned in the entire _Guidelines_ (besides its own tagdoc) is in the remakrs of elementSpec/@defaultExceptions! I will try to write something up shortly, but Lou is really much better at this than I.
9) @bibliography on the left: that's only on the paderborn jenkins, see: ...
Whew!
Am 22.01.2018 um 15:07 schrieb Syd Bauman
: 9) @bibliography on the left: that's only on the paderborn jenkins, see: ...
Whew! Yes, that’s a security constraint. Jenkins per default now prohibits execution of javascript etc. per Content-Security-Policy (https://content-security-policy.com/). Just learned about this and now need to investigate how to relax those restrictions …
Best Peter
I went through that a while ago. It's straightforward to turn it off. When they suddenly introduced it without warning, it caused us all sorts of problems because we use Jenkins builds to proof all our sites. On 2018-01-22 07:58 AM, Peter Stadler wrote:
Am 22.01.2018 um 15:07 schrieb Syd Bauman
: 9) @bibliography on the left: that's only on the paderborn jenkins, see: ...
Whew! Yes, that’s a security constraint. Jenkins per default now prohibits execution of javascript etc. per Content-Security-Policy (https://content-security-policy.com/). Just learned about this and now need to investigate how to relax those restrictions …
Best Peter
#DEFCON
Take a look at https://bauman.zapto.org/~syd/temp/4TEICouncil/TD_DEFCON.html and let me know what you think.
I'm in favour of the list
#DEFCONTEI
3) for consistency reasons I'd delete the "an" in the specification of <alternate>
I think both the <desc> for <sequence> and the <desc> for <alternate> are pretty lame. How about: <sequence>: indicates that the constructs referenced by its children form a sequence <alternate>: indicates that the constructs referenced by its children form an alternation
Agreed, this is much better
4) explanation of the second example: is it worth to mention the difference in using the cardinality on <elementRef> or <alternate>?
I don't think it can hurt, but I was sort of thinking (at the time) that even what I have is overkill, as this is covered in the Gentle Introduction to XML (at #SG146).
Agreed as well, if one wants to change the content model they are likely aware of the difference... -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council PLEASE NOTE: postings to this list are publicly archived
participants (4)
-
Martin Holmes
-
Peter Stadler
-
Scholger, Martina (martina.scholger@uni-graz.at)
-
Syd Bauman