Re: [tei-council] Processing Model Documentation for TEI Guidelines
I started looking at this, but something seems to have gone wrong in the conversion to doc e.g. * *"*The <model> element is the basis of any processing model documentation. foundation The <model> element is used to document the intended processing model for a particular element in an abstract manner which separates . A required @behaviour attribute which documents the processing function and controls which processing function should be used to present this element in output. * " is gibberish. Personally I would *much* rather edit/comment on the ODD source, which must exist somewhere. On 08/09/15 16:08, James Cummings wrote:
Hi all,
I've been taking the documentation in the tei-pm.odd and rewriting it to be something which could be added to the TEI Guidelines. I've put it up as a google doc with open editing for those of you who wish to improve it. This will (of course) be encoded in TEI, it is merely being placed here for ease of collaborative authorship. I believe that the appropriate place for it is either 22.4.8 shortly after http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDENT or another possibility is as a new 22.5 (pushing the current one down to 22.6).
https://docs.google.com/document/d/1C1fw5SCrJBZxT7O7-_HLrkBQJk5YZZJzzDbA-ir0...
Feel free to improve it, and if you have any questions or comments please make them here on the TEI Simple mailing list.
-James
Apologies, that was a cut-and-paste editing error on my part. I've put it back to what I had intended. There is currently no ODD of this version of the document, since the point of putting it in google docs was to enable proofreading by those less adept at reading TEI ODDs directly. If you give it a few more days I'll transform it back and add it to the tei-pm.odd file on github. But do point out any similar errors -- although I've read it through a couple times I've clearly just been blind while doing so (as others have corrected other tiny errors). -James On 10/09/15 14:31, Lou Burnard wrote:
I started looking at this, but something seems to have gone wrong in the conversion to doc e.g. * *"*The <model> element is the basis of any processing model documentation. foundation The <model> element is used to document the intended processing model for a particular element in an abstract manner which separates . A required @behaviour attribute which documents the processing function and controls which processing function should be used to present this element in output. * "
is gibberish.
Personally I would *much* rather edit/comment on the ODD source, which must exist somewhere.
On 08/09/15 16:08, James Cummings wrote:
Hi all,
I've been taking the documentation in the tei-pm.odd and rewriting it to be something which could be added to the TEI Guidelines. I've put it up as a google doc with open editing for those of you who wish to improve it. This will (of course) be encoded in TEI, it is merely being placed here for ease of collaborative authorship. I believe that the appropriate place for it is either 22.4.8 shortly after http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDENT or another possibility is as a new 22.5 (pushing the current one down to 22.6).
https://docs.google.com/document/d/1C1fw5SCrJBZxT7O7-_HLrkBQJk5YZZJzzDbA-ir0...
Feel free to improve it, and if you have any questions or comments please make them here on the TEI Simple mailing list.
-James
-- Dr James Cummings, James.Cummings@it.ox.ac.uk Academic IT Services, University of Oxford
I added a bunch of comments to the doc before my battery ran out. I think it's got some way to go still, frankly. On 10/09/15 16:59, James Cummings wrote:
Apologies, that was a cut-and-paste editing error on my part. I've put it back to what I had intended.
There is currently no ODD of this version of the document, since the point of putting it in google docs was to enable proofreading by those less adept at reading TEI ODDs directly. If you give it a few more days I'll transform it back and add it to the tei-pm.odd file on github.
But do point out any similar errors -- although I've read it through a couple times I've clearly just been blind while doing so (as others have corrected other tiny errors).
-James
On 10/09/15 14:31, Lou Burnard wrote:
I started looking at this, but something seems to have gone wrong in the conversion to doc e.g. * *"*The <model> element is the basis of any processing model documentation. foundation The <model> element is used to document the intended processing model for a particular element in an abstract manner which separates . A required @behaviour attribute which documents the processing function and controls which processing function should be used to present this element in output. * "
is gibberish.
Personally I would *much* rather edit/comment on the ODD source, which must exist somewhere.
On 08/09/15 16:08, James Cummings wrote:
Hi all,
I've been taking the documentation in the tei-pm.odd and rewriting it to be something which could be added to the TEI Guidelines. I've put it up as a google doc with open editing for those of you who wish to improve it. This will (of course) be encoded in TEI, it is merely being placed here for ease of collaborative authorship. I believe that the appropriate place for it is either 22.4.8 shortly after http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDENT or another possibility is as a new 22.5 (pushing the current one down to 22.6).
https://docs.google.com/document/d/1C1fw5SCrJBZxT7O7-_HLrkBQJk5YZZJzzDbA-ir0...
Feel free to improve it, and if you have any questions or comments please make them here on the TEI Simple mailing list.
-James
On 10/09/15 17:03, Lou Burnard wrote:
I added a bunch of comments to the doc before my battery ran out. I think it's got some way to go still, frankly.
I can't see them in the google doc so maybe make sure they got saved when you get some battery charge. Otherwise I'm more than happy to be led by your experience with writing Guidelines prose. -James
On 10/09/15 16:59, James Cummings wrote:
Apologies, that was a cut-and-paste editing error on my part. I've put it back to what I had intended.
There is currently no ODD of this version of the document, since the point of putting it in google docs was to enable proofreading by those less adept at reading TEI ODDs directly. If you give it a few more days I'll transform it back and add it to the tei-pm.odd file on github.
But do point out any similar errors -- although I've read it through a couple times I've clearly just been blind while doing so (as others have corrected other tiny errors).
-James
On 10/09/15 14:31, Lou Burnard wrote:
I started looking at this, but something seems to have gone wrong in the conversion to doc e.g. * *"*The <model> element is the basis of any processing model documentation. foundation The <model> element is used to document the intended processing model for a particular element in an abstract manner which separates . A required @behaviour attribute which documents the processing function and controls which processing function should be used to present this element in output. * "
is gibberish.
Personally I would *much* rather edit/comment on the ODD source, which must exist somewhere.
On 08/09/15 16:08, James Cummings wrote:
Hi all,
I've been taking the documentation in the tei-pm.odd and rewriting it to be something which could be added to the TEI Guidelines. I've put it up as a google doc with open editing for those of you who wish to improve it. This will (of course) be encoded in TEI, it is merely being placed here for ease of collaborative authorship. I believe that the appropriate place for it is either 22.4.8 shortly after http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDENT or another possibility is as a new 22.5 (pushing the current one down to 22.6).
https://docs.google.com/document/d/1C1fw5SCrJBZxT7O7-_HLrkBQJk5YZZJzzDbA-ir0...
Feel free to improve it, and if you have any questions or comments please make them here on the TEI Simple mailing list.
-James
-- Dr James Cummings, James.Cummings@it.ox.ac.uk Academic IT Services, University of Oxford
Oh, the comments have miraculously appeared. Thanks! -James On 10/09/15 17:06, James Cummings wrote:
On 10/09/15 17:03, Lou Burnard wrote:
I added a bunch of comments to the doc before my battery ran out. I think it's got some way to go still, frankly.
I can't see them in the google doc so maybe make sure they got saved when you get some battery charge. Otherwise I'm more than happy to be led by your experience with writing Guidelines prose.
-James
On 10/09/15 16:59, James Cummings wrote:
Apologies, that was a cut-and-paste editing error on my part. I've put it back to what I had intended.
There is currently no ODD of this version of the document, since the point of putting it in google docs was to enable proofreading by those less adept at reading TEI ODDs directly. If you give it a few more days I'll transform it back and add it to the tei-pm.odd file on github.
But do point out any similar errors -- although I've read it through a couple times I've clearly just been blind while doing so (as others have corrected other tiny errors).
-James
On 10/09/15 14:31, Lou Burnard wrote:
I started looking at this, but something seems to have gone wrong in the conversion to doc e.g. * *"*The <model> element is the basis of any processing model documentation. foundation The <model> element is used to document the intended processing model for a particular element in an abstract manner which separates . A required @behaviour attribute which documents the processing function and controls which processing function should be used to present this element in output. * "
is gibberish.
Personally I would *much* rather edit/comment on the ODD source, which must exist somewhere.
On 08/09/15 16:08, James Cummings wrote:
Hi all,
I've been taking the documentation in the tei-pm.odd and rewriting it to be something which could be added to the TEI Guidelines. I've put it up as a google doc with open editing for those of you who wish to improve it. This will (of course) be encoded in TEI, it is merely being placed here for ease of collaborative authorship. I believe that the appropriate place for it is either 22.4.8 shortly after http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDENT or another possibility is as a new 22.5 (pushing the current one down to 22.6).
https://docs.google.com/document/d/1C1fw5SCrJBZxT7O7-_HLrkBQJk5YZZJzzDbA-ir0...
Feel free to improve it, and if you have any questions or comments please make them here on the TEI Simple mailing list.
-James
-- Dr James Cummings, James.Cummings@it.ox.ac.uk Academic IT Services, University of Oxford
This is another reason I hate GoogleDocs. If you lose internet connectivty it looks as if your comments are saved but they're in limbo till your machine gets online again. On 10/09/15 17:08, James Cummings wrote:
Oh, the comments have miraculously appeared. Thanks!
-James
On 10/09/15 17:06, James Cummings wrote:
On 10/09/15 17:03, Lou Burnard wrote:
I added a bunch of comments to the doc before my battery ran out. I think it's got some way to go still, frankly.
I can't see them in the google doc so maybe make sure they got saved when you get some battery charge. Otherwise I'm more than happy to be led by your experience with writing Guidelines prose.
-James
On 10/09/15 16:59, James Cummings wrote:
Apologies, that was a cut-and-paste editing error on my part. I've put it back to what I had intended.
There is currently no ODD of this version of the document, since the point of putting it in google docs was to enable proofreading by those less adept at reading TEI ODDs directly. If you give it a few more days I'll transform it back and add it to the tei-pm.odd file on github.
But do point out any similar errors -- although I've read it through a couple times I've clearly just been blind while doing so (as others have corrected other tiny errors).
-James
On 10/09/15 14:31, Lou Burnard wrote:
I started looking at this, but something seems to have gone wrong in the conversion to doc e.g. * *"*The <model> element is the basis of any processing model documentation. foundation The <model> element is used to document the intended processing model for a particular element in an abstract manner which separates . A required @behaviour attribute which documents the processing function and controls which processing function should be used to present this element in output. * "
is gibberish.
Personally I would *much* rather edit/comment on the ODD source, which must exist somewhere.
On 08/09/15 16:08, James Cummings wrote:
Hi all,
I've been taking the documentation in the tei-pm.odd and rewriting it to be something which could be added to the TEI Guidelines. I've put it up as a google doc with open editing for those of you who wish to improve it. This will (of course) be encoded in TEI, it is merely being placed here for ease of collaborative authorship. I believe that the appropriate place for it is either 22.4.8 shortly after http://www.tei-c.org/release/doc/tei-p5-doc/en/html/TD.html#TDENT or another possibility is as a new 22.5 (pushing the current one down to 22.6).
https://docs.google.com/document/d/1C1fw5SCrJBZxT7O7-_HLrkBQJk5YZZJzzDbA-ir0...
Feel free to improve it, and if you have any questions or comments please make them here on the TEI Simple mailing list.
-James
participants (2)
-
James Cummings -
Lou Burnard