Skip to content

Commit

Permalink
Merge pull request oasis-tcs#709 from keberlein/prep-for-accessibilit…
Browse files Browse the repository at this point in the history
…y-review

Update source files in preparation for review 0: accessibility
  • Loading branch information
keberlein authored Jun 13, 2022
2 parents 342f8a9 + 76ea1d2 commit e48c690
Show file tree
Hide file tree
Showing 3 changed files with 11 additions and 22 deletions.
24 changes: 8 additions & 16 deletions specification/archSpec/base/accessibletablemarkup.dita
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,6 @@
</metadata>
</prolog>
<conbody>
<!--<draft-comment author="Kristen J Eberlein" time="28 March 2022"><p>This topic needs a more extensive edit than I did, including:</p><ul><li>Ensuring that the vocabulary aligns with how we describe complex and simple tables in the element-reference topics</li><li>Introducing the content outlined in the definition list</li><li>Alphabeticizing the entries in the definition list</li><li>Recasting the wording for the column headers and irregular headers to focus on what can be done with markup, instead of specifying what an author should do</li></ul></draft-comment>-->
<draft-comment author="Kristen J Eberlein" time="09 June 2022">
<p>I removed the following sentence from the short description, since
this topic does not really describe accessibility guidelines: "This
topic describes common accessibility guidelines that are related to
tables, along with the DITA markup that is designed to support
them."</p>
</draft-comment>
<!--<p>DITA provides two table models, a more complex one using the <xmlelement>table</xmlelement> element and a simple one that used the <xmlelement>simpletable</xmlelement> element. The <xmlelement>table</xmlelement> element is based on the OASIS Exchange Table Model, while the <xmlelement>simpletable</xmlelement> element reflects a simpler model that is closer to an HTML table. Each table model is addressed here. </p>-->
<p><ph
conref="../../langRef/containers/table-elements.dita#table2/table-types"
Expand Down Expand Up @@ -62,14 +54,14 @@
<xmlatt>scope</xmlatt> attribute in the first entry in
the first row to can be set to <keyword>col</keyword> to
indicate that it is a header for the entire column.</dd>
<dd>(Other columns) The <xmlelement>colspec</xmlelement> element can define which
columns function as headers. For that case, set the <xmlatt>rowheader</xmlatt>
attribute to <keyword>headers</keyword> on the column or columns that function as
headers. Alternatively, set the <xmlatt>scope</xmlatt> attribute on each relevant
entry in the first row to <keyword>col</keyword>, indicating that the entry is a
header for the entire column.<draft-comment author="Kristen J Eberlein"
time="09 June 2022">The last sentence in "Other columns" seems off; Robert, please
verify that this is what you wanted to say.</draft-comment></dd>
<dd>(Other columns) The <xmlelement>colspec</xmlelement>
element can define which columns function as headers. For
that case, set the <xmlatt>rowheader</xmlatt> attribute to
<keyword>headers</keyword> on the column or columns that
function as headers. Alternatively, set the
<xmlatt>scope</xmlatt> attribute on each relevant entry
in the first row to <keyword>col</keyword>, indicating that
the entry is a header for the entire column.</dd>
</dlentry>
<dlentry>
<dt>Simple table</dt>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,6 @@
<conbody>
<p>The following code sample references an image <filepath>workflow.png</filepath>.
Alternate text describes the workflow that is shown in the image.</p>
<draft-comment author="Kristen J Eberlein" time="09 June 2022">
<p>I think we should include the image.</p>
</draft-comment>
<codeblock>&lt;image href="workflow.png">
&lt;alt>The image is a workflow diagram that shows a ticketing workflow.
The initial status is "Open". From there, the ticket can move to
Expand Down
6 changes: 3 additions & 3 deletions specification/dita-2.0-key-definitions-cover-pages.ditamap
Original file line number Diff line number Diff line change
Expand Up @@ -9,18 +9,18 @@
<!-- Make common variable content available -->
<topicref href="common/conref-cover-pages.dita" processing-role="resource-only"/>
<keydef keys="stage">
<!--Used in the master maps as a title-->
<!--Used in the mains maps as a title-->
<!-- Also used in the "Citation format" section.-->
<topicmeta>
<keywords>
<keyword>Working Draft 25</keyword>
<keyword>Working Draft 26</keyword>
</keywords>
</topicmeta>
</keydef>
<keydef keys="stage-date">
<topicmeta>
<keywords>
<keyword>05 April 2022</keyword>
<keyword>13 June 2022</keyword>
</keywords>
</topicmeta>
</keydef>
Expand Down

0 comments on commit e48c690

Please sign in to comment.