Menu

#366 Guidelines, p. 384 - number of <rdg> in <app>

GREEN
closed-fixed
1(low)
2013-06-18
2012-03-05
No

"each <app> must contain at least one <rdg>."

Comment: The schema only requires one, but what is a <app> with only one <rdg> (and no <lem>) supposed to mean?

Discussion

1 2 > >> (Page 1 of 2)
  • Jens Østergaard Petersen

    • summary: 384 --> Guidelines, p. 384 - number of <rdg> in <app>
     
  • Lou Burnard

    Lou Burnard - 2012-03-13

    I suppose one might more accurately require that an app should contain either
    (a) one lem and one or more rdgs
    or (b) two or more rdgs
    The situation arises because some people want to record just <rdg>s without characterising any of them as <lem>s, while others insist on that possibility. If my supposition is correct, the appropriate action would probably be to add a schematron rule to enforce it.

     
  • Lou Burnard

    Lou Burnard - 2012-03-13
    • milestone: --> 871214
     
  • James Cummings

    James Cummings - 2012-04-15

    I almost never use <lem> as I don't want to privilege one reading over another in the encoding.... that is what output is for.

    I've had <app> with one <rdg> when using nested <app> but only to keep consistency in the markup to make processing easier. (I'm not recommending this as good practice).

    Some people like to tessellate <app> entirely over their content even when all witnesses agree. That would be another case one might encounter a single rdg inside an app. I can see the argument that this should be considered poor practice.

    -james

     
  • BODARD Gabriel

    BODARD Gabriel - 2012-04-16

    The use-case where there's only one <rdg/> is something that we introduced a couple of years ago, to cater for the kind of apparatus that is not strictly variant readings, but possibly attributing the origin of a reading to a given editor or witness without necessarily having to give a lemma or other readings, adding an editorial note to a reading, etc.

    I emphatically don't think this is a bug, therefore, even if it's something that _you_ might not want to use in an old-fashioned critical apparatus of variant readings.

     
  • Lou Burnard

    Lou Burnard - 2012-04-16
    • assigned_to: nobody --> martindholmes
    • status: open --> pending
     
  • Lou Burnard

    Lou Burnard - 2012-04-16

    As Gabriel says, there are use cases for having just a rdg within an app. We propose to leave the content model unchanged and to add a schematron constraint to check for the existence of at least one rdg.

     
  • BODARD Gabriel

    BODARD Gabriel - 2012-04-17

    No, actually I think it was deliberate to allow an <app> with no <rdg> as well. (The use-case envisaged was just a <ptr> [to an app, choice, subst or similar construction in the transcription] and/or a <note> with editorial observations on it.) This again is the case of <app> used for something slightly wider than merely variant readings, as it is in (e.g.) epigraphy, as opposed to MS studies.

    Can we revisit this decision, please?

     
  • BODARD Gabriel

    BODARD Gabriel - 2012-04-17
    • status: pending --> open
     
  • Jens Østergaard Petersen

    While I can see the use for <app>s with no or only a single <rdg>, my bug report was concerned with the text of the Guidelines, and such uses of <app> are nowhere discussed there. Therefore, until such a discussion is introduced, I would suggest to remove "; each <app> must contain at least one <rdg>", because it introduces the possibility of an <app> containing a single <rdg> (or a <lem> with no <rdg>, I presume), which will be mystifying to those who base themselves on the text of the Guidelines alone. I warmly support Gabriel's 2006 proposal: I see immediate use cases for this.

     
  • BODARD Gabriel

    BODARD Gabriel - 2012-07-31

    I agree that there is a problem in the Guidelines here. I suggest that the solution is not to insert a schematron rule to enforce the minimum-one-rdg rule, but to rewrite the guidelines to:

    1. remove the statement that at least 1 rdg is required;

    2. provide examples of usage of app with less than min <lem>+<rdg>

    3. provide examples of usage of app with <ptr> and <note>, both with and without rdg/lem

    (I can provide examples of 2+3, but they'll be in Greek and Latin. English examples anyone?)

     
  • James Cummings

    James Cummings - 2012-09-19
    • milestone: 871214 --> GREEN
    • assigned_to: martindholmes --> gabrielbodard
     
  • James Cummings

    James Cummings - 2012-09-19

    Council agrees with Gaby's last comment and assigns to him to implement. (face to face 2012-09)

     
  • BODARD Gabriel

    BODARD Gabriel - 2012-10-22

    Removed schematron constraint and changed description to read, "with an optional lemma and usually one or more reading or a note on the relevant passage." (at r10988).

    Not closing ticket because examples of (2) and (3) below still need added.

     
  • BODARD Gabriel

    BODARD Gabriel - 2013-06-18

    Examples of <app> without <lem>, and with <ptr> and <note> added at r12269.

     
  • BODARD Gabriel

    BODARD Gabriel - 2013-06-18
    • status: open --> closed-fixed
    • Priority: 5 --> 1(low)
     
  • BODARD Gabriel

    BODARD Gabriel - 2013-06-18
    • status: closed-fixed --> open-accepted
     
  • BODARD Gabriel

    BODARD Gabriel - 2013-06-18

    reopened, because it seems I mistakenly assumed <ptr> was available in <app> whenit has apparently never been. I suppose the function I have imagined for it (i.e. pointing to a choice or app element in the text itself) is more or less covered by @loc? (But @loc isn't a pointer?)

     
  • James Cummings

    James Cummings - 2013-06-18

    In that case isn't the recommendation to use @from which is a pointer? c.f. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TC.html#TCAPLN

     
    • BODARD Gabriel

      BODARD Gabriel - 2013-06-18

      Right, I was wondering about that, but was put off by the remark "This attribute is only used when the double-end point method of apparatus markup is used", and the examples I'm thinking of use the "location-referenced method". Does this matter?

      (If not, should the remark be cleared up a bit?)

       

      Last edit: BODARD Gabriel 2013-06-18
  • BODARD Gabriel

    BODARD Gabriel - 2013-06-18

    I've recast the two examples with @loc or @corresp instead of <ptr>, at r12272

     
  • James Cummings

    James Cummings - 2013-06-18

    I would vote for the notes on app's @from and @to being changed or removed. I think the prose of the guidelines allows for using them in a location referenced method.

     
    • BODARD Gabriel

      BODARD Gabriel - 2013-06-18

      Fair enough. I've changed the example to use @from instead of @corresp (r12273). Do you want to open a new ticket to discuss the GL change, or do that here?

       
  • BODARD Gabriel

    BODARD Gabriel - 2013-06-18

    After discussion with the Council, I've changed the wording of those notes slightly to better reflect the reality of how @from is used (as a pointer in location-referenced as well as in double-end point), at [r12278], and am now closing this ticket.

     

    Related

    Commit: [r12278]


    Last edit: BODARD Gabriel 2013-06-24
1 2 > >> (Page 1 of 2)