proofing processing model section
A WWP encoder (CCed) was kind enough to read through section 22.5 "Documenting a Processing Model". Here are her comments. Note that she was reading version 2.8.1a, last updated on 2015-12-17, revision 3df969c (which I generated from an updated pm branch on 2016-02-22).
1) My initial question in looking at this was, “what exactly is a processing model?” - this sentence in section 22.5, "In this case a processing model is a template description for how the element should be transformed in one or more particular outputs” confused me slightly because it implies that the definition of a processing model changes depending on its “case” or use, which you explain further here "This is a method for documenting one or more possible processing models in abstract terms and it should be clear that processing of such documents is not limited to only these possibilities." Nevertheless, even though you want to leave the possibility open for multiple processing scenarios, it might be helpful to have a more outright definition of processing models from the beginning. If your target audience is any TEI-interested user who is exploring the guidelines, not just those familiar with processing models, it could be worth opening with a more standard definition.
2) Since this larger section (22.5 - 22.5.5) is about the output for TEI texts, I'm wondering if the section should appear towards the end of the chapter - after the sections on schema development? Basically, I wasn't sure why this section appeared in middle of the chapter after the "Common Elements" section - though that could be because I have only a rough understanding of processing models. ... Hopefully these notes / comments are helpful and are what you were looking for. Overall I found this section very approachable in terms of pacing, coverage, organization. Let me know if there is any other way I can help.
Thanks for passing on the comments Syd. We have tried to address both the points raised here -- a degree of uncertainty about what exactly this thing is for, and the place within the chapter where it should reside -- in the current version. If your colleague has time to re-read that, it's at http://teic.github.io/TEI/TD.html#TDPM : the version you mention is quite antique. We've recently made a few more clarificatory changes which aren't in the github pages yet, and section 22.5.5.8 in particular is due for a complete rewrite. The place these elements get discussed is dictated by the overall organization of the chapter. These elements are a part of the specification of the <elementSpec> element. L On 29/02/16 19:14, Syd Bauman wrote:
A WWP encoder (CCed) was kind enough to read through section 22.5 "Documenting a Processing Model". Here are her comments. Note that she was reading version 2.8.1a, last updated on 2015-12-17, revision 3df969c (which I generated from an updated pm branch on 2016-02-22).
1) My initial question in looking at this was, “what exactly is a processing model?” - this sentence in section 22.5, "In this case a processing model is a template description for how the element should be transformed in one or more particular outputs” confused me slightly because it implies that the definition of a processing model changes depending on its “case” or use, which you explain further here "This is a method for documenting one or more possible processing models in abstract terms and it should be clear that processing of such documents is not limited to only these possibilities." Nevertheless, even though you want to leave the possibility open for multiple processing scenarios, it might be helpful to have a more outright definition of processing models from the beginning. If your target audience is any TEI-interested user who is exploring the guidelines, not just those familiar with processing models, it could be worth opening with a more standard definition.
2) Since this larger section (22.5 - 22.5.5) is about the output for TEI texts, I'm wondering if the section should appear towards the end of the chapter - after the sections on schema development? Basically, I wasn't sure why this section appeared in middle of the chapter after the "Common Elements" section - though that could be because I have only a rough understanding of processing models. ... Hopefully these notes / comments are helpful and are what you were looking for. Overall I found this section very approachable in terms of pacing, coverage, organization. Let me know if there is any other way I can help.
Hi Syd, I believe that is the wrong branch, which I have now deleted to avoid confusion. The correct branch is the lb43-procmod one because that is post-PureODD. -James On 29/02/16 19:14, Syd Bauman wrote:
A WWP encoder (CCed) was kind enough to read through section 22.5 "Documenting a Processing Model". Here are her comments. Note that she was reading version 2.8.1a, last updated on 2015-12-17, revision 3df969c (which I generated from an updated pm branch on 2016-02-22).
1) My initial question in looking at this was, “what exactly is a processing model?” - this sentence in section 22.5, "In this case a processing model is a template description for how the element should be transformed in one or more particular outputs” confused me slightly because it implies that the definition of a processing model changes depending on its “case” or use, which you explain further here "This is a method for documenting one or more possible processing models in abstract terms and it should be clear that processing of such documents is not limited to only these possibilities." Nevertheless, even though you want to leave the possibility open for multiple processing scenarios, it might be helpful to have a more outright definition of processing models from the beginning. If your target audience is any TEI-interested user who is exploring the guidelines, not just those familiar with processing models, it could be worth opening with a more standard definition.
2) Since this larger section (22.5 - 22.5.5) is about the output for TEI texts, I'm wondering if the section should appear towards the end of the chapter - after the sections on schema development? Basically, I wasn't sure why this section appeared in middle of the chapter after the "Common Elements" section - though that could be because I have only a rough understanding of processing models. ... Hopefully these notes / comments are helpful and are what you were looking for. Overall I found this section very approachable in terms of pacing, coverage, organization. Let me know if there is any other way I can help.
-- Dr James Cummings, James.Cummings@it.ox.ac.uk Academic IT Services, University of Oxford
He means lb42 not lb43 of course Sent from my Honor Mobile -------- Original Message -------- Subject: Re: [tei-council] proofing processing model section From: James Cummings To: s.bauman@neu.edu,tei-council@lists.tei-c.org CC: Hi Syd, I believe that is the wrong branch, which I have now deleted to avoid confusion. The correct branch is the lb43-procmod one because that is post-PureODD. -James On 29/02/16 19:14, Syd Bauman wrote:
A WWP encoder (CCed) was kind enough to read through section 22.5 "Documenting a Processing Model". Here are her comments. Note that she was reading version 2.8.1a, last updated on 2015-12-17, revision 3df969c (which I generated from an updated pm branch on 2016-02-22).
1) My initial question in looking at this was, “what exactly is a processing model?” - this sentence in section 22.5, "In this case a processing model is a template description for how the element should be transformed in one or more particular outputs” confused me slightly because it implies that the definition of a processing model changes depending on its “case” or use, which you explain further here "This is a method for documenting one or more possible processing models in abstract terms and it should be clear that processing of such documents is not limited to only these possibilities." Nevertheless, even though you want to leave the possibility open for multiple processing scenarios, it might be helpful to have a more outright definition of processing models from the beginning. If your target audience is any TEI-interested user who is exploring the guidelines, not just those familiar with processing models, it could be worth opening with a more standard definition.
2) Since this larger section (22.5 - 22.5.5) is about the output for TEI texts, I'm wondering if the section should appear towards the end of the chapter - after the sections on schema development? Basically, I wasn't sure why this section appeared in middle of the chapter after the "Common Elements" section - though that could be because I have only a rough understanding of processing models. ... Hopefully these notes / comments are helpful and are what you were looking for. Overall I found this section very approachable in terms of pacing, coverage, organization. Let me know if there is any other way I can help.
-- Dr James Cummings, James.Cummings@it.ox.ac.uk Academic IT Services, University of Oxford -- 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 (3)
-
James Cummings -
Lou Burnard -
Syd Bauman