TEI-Council-FAQ - Revision history

Syd: add new Pending status

2024-10-18T17:49:12Z

add new Pending status

Syd: entirely re-write, as my recollection of the War on Attributes does not involve concerns of abuse mitigated by datatypes at all.

2024-10-18T17:27:43Z

entirely re-write, as my recollection of the War on Attributes does not involve concerns of abuse mitigated by datatypes at all.

Hcayless: /* What funding is available for Council Activities? And how do I get reimbursed? */

2023-09-19T14:20:28Z

‎What funding is available for Council Activities? And how do I get reimbursed?

Seifert: /* How do I edit the TEI Guidelines? */

2023-08-10T14:51:09Z

‎How do I edit the TEI Guidelines?

Seifert: /* And what work does it do? */

2023-08-10T14:49:17Z

‎And what work does it do?

Hcayless: /* Terminology */

2019-10-08T15:47:16Z

‎Terminology

Hcayless: /* What funding is available for Council Activities? And how do I get reimbursed? */

2019-10-08T15:30:02Z

‎What funding is available for Council Activities? And how do I get reimbursed?

Hcayless: /* I want to add a document to add meeting minutes, reports, or working papers to the TEI-C website. How do I do that? */

2019-10-08T14:56:28Z

‎I want to add a document to add meeting minutes, reports, or working papers to the TEI-C website. How do I do that?

Hcayless: /* Why are some people on the Council email list or attending Council meetings even though they are not on the list of elected members? */

2019-10-08T14:53:59Z

‎Why are some people on the Council email list or attending Council meetings even though they are not on the list of elected members?

Hcayless: /* How does the Council do its work? */

2019-10-08T14:53:21Z

‎How does the Council do its work?

← Older revision		Revision as of 17:49, 18 October 2024
Line 177:		Line 177:

	* '<span style="color:orange; font-weight:bold;">Status: Needs Discussion</span>' means that the issue has not been talked about enough yet to resolve it. New issues nearly always go into this status first. When Council has face-to-face meetings, these are usually the issues we target first.		* '<span style="color:orange; font-weight:bold;">Status: Needs Discussion</span>' means that the issue has not been talked about enough yet to resolve it. New issues nearly always go into this status first. When Council has face-to-face meetings, these are usually the issues we target first.
		+
		+	* '<span style="color: #5319E7; font-weight:bold;">Status: Pending</span>' means that the issue is pending some work. Often this means that some work is to be done (typically in a branch named after the issue) and then discussed by Council..

	* '<span style="color:green; font-weight:bold;">Status: Go</span>' means that the ticket has been discussed, there is general consensus on what the correct thing to do is, and it has been assigned for someone to ensure its implementation.		* '<span style="color:green; font-weight:bold;">Status: Go</span>' means that the ticket has been discussed, there is general consensus on what the correct thing to do is, and it has been assigned for someone to ensure its implementation.

@@ Line 87: / Line 87: @@
 === What was the War on Free-text-bearing Attribute Values? ===
-The War on Free-text-bearing Attribute Values, also known as the War on Free-text-bearing Attributes and the War on Attributes for short, happened because some have felt that if attribute values don't have a datatype, they are more prone to abuse than if they did.  So there has been an effort to give datatypes to as many attributes as possible.  Some discussion of this with respect to @rend is available here: http://blogs.oucs.ox.ac.uk/jamesc/2011/12/01/rend-and-the-war-on-text-bearing-attributes/
+The move from SGML to XML included (some would say necessitated) The War on Free-text-bearing Attribute Values, also known as the War on Free-text-bearing Attributes or the War on Attributes for short. This war was an effort to disallow free text in the value of any attribute recommended by the ''Guidelines''. There were two main reasons for this.
 === What is the "Birnbaum doctrine"? ===

@@ Line 149: / Line 149: @@
 If the council has a meeting, then the council members' travel, hotel, etc. will be reimbursed with proper receipts.  The TEI reimburses all reasonable expenses in keeping with standard practice at most universities and granting agencies. We cover meals, travel, lodging, and other common daily travel expenses. Airfare should be economy class and direct return, unless otherwise arranged with the Treasurer prior to your trip.  If you have questions about reimbursement procedures, including what is reimbursable, please email Hugh Cayless, the TEI treasurer, at philomousos AT gmail.com.
-Use the TEI Travel expense form available here: https://www.tei-c.org/wp-content/uploads/2017/10/TEI_travel_form.pdf  '''Expense forms should be submitted within 1 month of the end of the meeting.'''
+Use the TEI Travel expense form available here: https://tei-c.org/tei_travel_form/  '''Expense forms should be submitted within 1 month of the end of the meeting.'''
 == How we get work done ==

@@ Line 186: / Line 186: @@
 === How do I edit the TEI Guidelines? ===
-Editing the TEI Guidelines is a complex process and the Council has produced a document http://www.tei-c.org/Activities/Council/Working/tcw20.xml covering the logical and physical layout of the Guidelines, stylistic notes, how to make a change to the Guidelines (it requires [[TEI-Council-FAQ#How_do_I_use_GitHub.3F|using subversion]], building a release, and a reference section of useful information.  If any information you need isn't in this document, ask on the Council list and get someone to update it!
+Editing the TEI Guidelines is a complex process and the Council has produced a document http://www.tei-c.org/Activities/Council/Working/tcw20.xml covering the logical and physical layout of the Guidelines, stylistic notes, how to make a change to the Guidelines (it requires [[TEI-Council-FAQ#How_do_I_use_GitHub.3F|using subversion]], building a release, and a reference section of useful information).  If any information you need isn't in this document, ask on the Council list and get someone to update it!
 === How can I find out about every time a change is made in the TEI GitHub repository? ===

@@ Line 15: / Line 15: @@
 # A bug report or feature request is reported by anyone at [https://github.com/TEIC/ GitHub] for the [https://github.com/TEIC/TEI/issues Guidelines] or [https://github.com/TEIC/Stylesheets/issues Stylesheets].
 # Sometimes others notice the ticket and comment on it.
-# Sometimes a Council member may make an executive decision on the ticket.  If it's a corrigible error or bug, we can just fix it in the appropriate ODD file(s) (also in GitHub). If it is not a real issue, sometimes the ticket will just be closed. If you do not have developer access on GitHub you'll to ask to be added to the Council team there. Otherwise, it's discussed either by email on the Council mailing list or at a Council meeting (conference call or in-person meeting).  Comments are recorded in the ticket reflecting the decision reached, and changes are made in GitHub by a member of the Council sometime thereafter.
+# Sometimes a Council member may make an executive decision on the ticket.  If it's a corrigible error or bug, we can just fix it in the appropriate ODD file(s) (also in GitHub). If it is not a real issue, sometimes the ticket will just be closed. If you do not have developer access on GitHub you'll ask to be added to the Council team there. Otherwise, it's discussed either by email on the Council mailing list or at a Council meeting (conference call or in-person meeting).  Comments are recorded in the ticket reflecting the decision reached, and changes are made in GitHub by a member of the Council sometime thereafter.
 # The change shows up on tei-c.org after the next TEI "release", which happens about two or three times a year.

@@ Line 80: / Line 80: @@
 == Terminology ==
 === What was the War on Free-text-bearing Attribute Values? ===
@@ Line 96: / Line 100: @@
 The "Durand Conundrum" was suggested by David G. Durand concerning the TEI's decision to use the [[ODD | TEI ODD]] meta-schema language rather than just one of the existing schema languages.  Given that we decided to use our own language, why use RelaxNG as part of that language for describing content models?  Generally, the consensus is that [[ODD | TEI ODD]] gives us greater power and flexibility than any individual schema language can do in that we can model things that those schema languages are currently unable to cope with. TEI ODD gives the ability for a single document to produce both documentation and schema since these are inherently interlinked. It also keeps the TEI honest, in requiring it to use its own system to document schemas.  [[ODD | TEI ODD]] does currently have some problems, a few of which are detailed at [[ODD-dev]] and successive revisions of TEI ODD are intended to solve some of these. Increasingly [[ODD#Future_plans:_.22Pure_ODD.22|the work on Pure ODD elements for content models and datatypes]] has cut the gordian knot of this problem.
 === What does "no magic" mean? ===
 'Magic' in the sense sometimes used in Council discussion refers to pre-existing or special knowledge required to process something.  For example, it was only by 'magic' that a TEI ODD processor would know to add attributes from the att.global attribute class to elements until this was changed to make all element specifications have to explicitly claim membership in this class if they wanted the global attributes.  Knowing to add them was 'magic', and in general it is better if any requirements or understood knowledge is explicitly documented. While some 'magic' of understood conventions or processing will always remain in complex technical systems, the Council strives to at very least enable the possibility of documenting the underlying rules when it discovers them.  James Cummings has been a fervent proponent of the removal of any understood 'magic' rules from the TEI.
 === What is a non-deterministic content model? ===
@@ Line 130: / Line 126: @@
 These are pairs of elements that are in a sense two sides of the same coin, such as orig and reg, corr and sic, abbr and expan.
 === What does it mean to say that elements tessellate? ===

@@ Line 150: / Line 150: @@
 === What funding is available for Council Activities? And how do I get reimbursed? ===
-The TEI funds the participation of the council members in the meetings.  Though I don't know of anyone claiming back telephone conferencing costs, I suppose that is possible as well, in most cases the council members' institutions probably swallow that.
+The TEI funds the participation of the council members in the meetings.
-If the council has a meeting, then the council members' travel, hotel, etc. will be reimbursed with proper receipts.  The TEI reimburses all reasonable expenses in keeping with standard practice at most universities and granting agencies. We cover meals, travel, lodging, and other common daily travel expenses. Airfare should be economy class and direct return, unless otherwise arranged with the Treasurer prior to your trip.  (See [http://www.tei-c.org/Board/procedures.xml#body.1_div.8 draft reimbursement policies and procedures].)  If you have questions about reimbursement procedures, including what is reimbursable, please email John Unsworth, the TEI treasurer, at john.m.unsworth AT gmail.com.
+If the council has a meeting, then the council members' travel, hotel, etc. will be reimbursed with proper receipts.  The TEI reimburses all reasonable expenses in keeping with standard practice at most universities and granting agencies. We cover meals, travel, lodging, and other common daily travel expenses. Airfare should be economy class and direct return, unless otherwise arranged with the Treasurer prior to your trip.  If you have questions about reimbursement procedures, including what is reimbursable, please email Hugh Cayless, the TEI treasurer, at philomousos AT gmail.com.
-Use the TEI Travel expense form available here: https://www.tei-c.org/wp-content/uploads/2017/10/TEI_travel_form.pdf  '''Expense forms should be submitted within 10 days of the end of the meeting.'''
+Use the TEI Travel expense form available here: https://www.tei-c.org/wp-content/uploads/2017/10/TEI_travel_form.pdf  '''Expense forms should be submitted within 1 month of the end of the meeting.'''
 == How we get work done ==

@@ Line 215: / Line 215: @@
 === I want to add a document to add meeting minutes, reports, or working papers to the TEI-C website.  How do I do that? ===
 The TEI has a longstanding naming convention for files that consists of:
@@ Line 226: / Line 222: @@
 # a two-digit number for the document with a committee series, numbered sequentially (e.g., "tcw01" is the first working paper from the Technical Council, "tcm05" is the fifth minutes from the Technical Council, etc.)
-There is no registry of documents, so when creating a new one, you simply name the file appropriately.
+These documents currently reside in the [https://github.com/TEIC/Documentation Documentation] repo on GitHub.
 === How do I get access to the Google Analytics Data for www.tei-c.org? ===

@@ Line 30: / Line 30: @@
 === Why are some people on the Council email list or attending Council meetings even though they are not on the list of elected members? ===
-In addition to the members of the Council, the chair of the TEI Technical Council may invite others not elected to the Council to meetings (e.g. to speak to a particular issue). Historically the Council often invited a representative of the Board to the Council mailing list and meetings. The TEI-C Webmaster (currently Kevin Hawkins) and Assistant Webmaster (Nick Homenda) are also on the mailing lists.
+In addition to the members of the Council, the chair of the TEI Technical Council may invite others not elected to the Council to meetings (e.g. to speak to a particular issue). Historically the Council often invited a representative of the Board to the Council mailing list and meetings. The TEI-C Webmaster (currently Luis Meneses) are also on the mailing lists.
 === What are the various job roles on the TEI Council? ===

@@ Line 5: / Line 5: @@
 === How does the Council do its work? ===
-By every means possible. These include monthly remote meetings, email, widely circulated discussion documents, and public debate in other contexts such as TEI-L and GitHub issues. The Council meets face to face twice a year (usually one of those meetings concurrent with the TEI Annual Meeting), and many more times than that virtually.
+By every means possible. These include monthly remote meetings, email, widely circulated discussion documents, and public debate in other contexts such as TEI-L and GitHub issues. The Council meets face to face twice a year (usually one of those meetings concurrent with the TEI Annual Meeting), and many more times than that virtually. Sub-groups of Council will often form around particularly large or complex issues and may meet separately to deal with them.
 === And what work does it do? ===