Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cleanup items: removing obsolete markup #397

Open
robander opened this issue Oct 20, 2020 · 15 comments
Open

Cleanup items: removing obsolete markup #397

robander opened this issue Oct 20, 2020 · 15 comments
Labels

Comments

@robander
Copy link
Contributor

As discussed at TC meeting October 20, 2020, as we get more deeply into editing the 2.0 spec we're finding items that are really obsolete and no longer needed. Many of these should have been marked deprecated in 1.3 or earlier, but were not noticed.

We will be treating these as fixes, but need to track to make sure that they are included in any migration instructions.

Items added to the list initially:

  • @othertype and @otherjob on <audience> are obsolete and can be removed
  • <itemgroup> is no longer useful, its function can be entirely filled by the <div> element
robander added a commit to robander/dita that referenced this issue Oct 20, 2020
robander added a commit to robander/dita that referenced this issue Oct 20, 2020
robander added a commit to robander/dita-techcomm that referenced this issue Oct 20, 2020
robander added a commit that referenced this issue Oct 20, 2020
Remove audience/@othertype, audience/@otherjob, itemgroup #397
robander added a commit to oasis-tcs/dita-techcomm that referenced this issue Oct 20, 2020
@robander
Copy link
Contributor Author

robander commented Dec 8, 2020

Based on discussion of this email on Dec 8 2020: https://lists.oasis-open.org/archives/dita/202012/msg00008.html

Adding the @mapkeyref attribute to the list of obsolete items to remove, from all three elements where it exists today.

robander added a commit to robander/dita that referenced this issue Dec 8, 2020
robander added a commit that referenced this issue Dec 8, 2020
@robander
Copy link
Contributor Author

Not a removal, but based on discussion at TC May 11, another cleanup item will restore the universal-attributes to specializations of body (missing as an oversight for several releases, ever since those elements were made optional): https://lists.oasis-open.org/archives/dita/202104/msg00020.html

@robander
Copy link
Contributor Author

Per discussion at TC May 18 2021, agreed to remove <sectiondiv> which is a subset of functionality now available with <div>.

robander added a commit to robander/dita that referenced this issue May 24, 2021
robander added a commit to robander/dita that referenced this issue May 24, 2021
robander added a commit to robander/dita that referenced this issue May 24, 2021
robander added a commit to robander/dita-techcomm that referenced this issue May 25, 2021
robander added a commit to robander/dita-techcomm that referenced this issue May 25, 2021
robander added a commit to oasis-tcs/dita-techcomm that referenced this issue May 25, 2021
@robander
Copy link
Contributor Author

robander commented Jun 1, 2021

Additional cleanup coming out of TC meeting June 1 2021:

  • Add @keyref to markup, xml mention domain elements
  • Remove longquoteref element from <lq>, remove linking attributes from <lq>; add @keyref to <lq>
  • Add @keyref to highlight and emphasis domain elements

robander added a commit to robander/dita that referenced this issue Jun 1, 2021
robander added a commit to robander/dita that referenced this issue Jun 1, 2021
robander added a commit to robander/dita that referenced this issue Jun 1, 2021
robander added a commit to robander/dita that referenced this issue Jun 1, 2021
robander added a commit that referenced this issue Jun 1, 2021
Remove longquoteref topic, add keyref to highlight elements #397
robander added a commit to robander/dita-techcomm that referenced this issue Jun 1, 2021
robander added a commit to oasis-tcs/dita-techcomm that referenced this issue Jun 2, 2021
@robander
Copy link
Contributor Author

robander commented Nov 2, 2021

Per TC meeting November 2, 2021, @title-role should be required in grammar files (as is already indicated by the text of the spec)

robander added a commit to robander/dita that referenced this issue Nov 8, 2021
robander added a commit that referenced this issue Nov 8, 2021
@robander
Copy link
Contributor Author

robander commented Jan 11, 2022

Per TC meeting January 11, 2011, voted to remove several obsolete items:

  • Remove @specentry and @spectitle from all elements
  • Remove has* elements and relatedSubjects from subject scheme
  • Remove <anchor>, <anchorref>, and map/@anchorref
  • Remove <subjectRelTable>

robander added a commit to robander/dita that referenced this issue Jan 11, 2022
robander added a commit that referenced this issue Feb 7, 2022
robander added a commit to robander/dita that referenced this issue Mar 16, 2022
@robander
Copy link
Contributor Author

Removing the following attributes from object, which are deprecated in HTML5 (including the "keyrefs" DITA version of removed attributes): archive, archivekeyrefs, classid, classidkeyref, codebase, codebasekeyref, declare, standby

robander added a commit to robander/dita that referenced this issue Mar 16, 2022
@robander
Copy link
Contributor Author

Same update for <param> removes type and valuetype

robander added a commit to robander/dita that referenced this issue Mar 16, 2022
robander added a commit that referenced this issue Mar 16, 2022
#397 remove obsolete object attrs
@robander
Copy link
Contributor Author

robander commented Apr 4, 2022

Realized that longdescref and longdescre (leftover from a DITA 1.0 typo) are still defined on object, and should have been removed with other deprecated objects -- they are not listed as valid attributes and they were replaced with <longdescref>. Making that update.

robander added a commit to robander/dita that referenced this issue Apr 4, 2022
robander added a commit that referenced this issue Apr 5, 2022
Remove obsolete longdescref att #397
@keberlein
Copy link
Contributor

At the TC meeting on 24 May 2022, we decided to remove the title attribute on reltable element

robander added a commit to robander/dita that referenced this issue Jun 14, 2022
robander added a commit that referenced this issue Jun 14, 2022
keberlein added a commit to keberlein/dita that referenced this issue Jun 14, 2022
…posal-647

* 'DITA-2.0' of https://github.com/oasis-tcs/dita:
  Remove title att from reltable oasis-tcs#397
  Update source files in preparation for review 0: accessibility
  Clean up draft comments in a11y topics
@robander
Copy link
Contributor Author

robander commented Jun 14, 2022

From recent TC meetings:
"Add changes to @scale for fig, lines, pre, and specializations of pre to list of "clean-up items" "

Removing enumeration so that any value is allowed for scale attribute, keeping enumerations only for table and simpletable

@robander
Copy link
Contributor Author

Per TC meeting June 14 2022, Eliot Kimber will be writing up the after-the-fact stage 3 proposal for this item.

robander added a commit to robander/dita that referenced this issue Jun 21, 2022
robander added a commit to robander/dita that referenced this issue Jun 21, 2022
robander added a commit to robander/dita that referenced this issue Jun 21, 2022
robander added a commit that referenced this issue Jun 21, 2022
Remove enumeration for scale, apart from table #397
robander added a commit to robander/dita-techcomm that referenced this issue Jun 21, 2022
robander added a commit to oasis-tcs/dita-techcomm that referenced this issue Jun 21, 2022
Relax scale values except simpletable oasis-tcs/dita#397
keberlein added a commit to keberlein/dita that referenced this issue Jul 13, 2022
…posal-647

* 'DITA-2.0' of https://github.com/oasis-tcs/dita:
  Incorporate edits from review O
  Update cover page metadata
  Update spec source for scale att oasis-tcs#397
  Remove enumeration for scale, apart from table oasis-tcs#397
  Incorporate edits from review O
  Correct typs
  Add rev marking for "review-o"
  Adds link from accessibility topic to WCAG
  Incorporate review comments from Bob Johnson
  Add "Closed" as a permitted value for disposition on <draft-comment>
  Adds rev attribute value for review O
  Revert "Adds draft comments from Content Fusion review"
  Adds draft comments from Content Fusion review
  Add bindings for disposition attr on draft-comment
  Edited new expansion topics (work in progress)
  Typo fix in heading
  replaced "DITAweb" with "Congility Web Server" as detailed in draft comment

# Conflicts:
#	specification/resources/DITA2.0-spec.ditaval
@ekimbernow
Copy link
Contributor

Working on the proposal now

@ekimbernow
Copy link
Contributor

Proposal reviewed and updated. Submitted for TC review 17 Oct 2022

infotexture pushed a commit to infotexture/dita-bootstrap that referenced this issue Feb 4, 2024
To ensure full compatibility with DITA 2.0, the reference to a
`<sectiondiv>` should be switched to a `<div>`. I've left `<sectiondiv>`
processing in as well for backward compatibility to DITA 1.4.

> Per discussion at TC May 18 2021, agreed to remove `<sectiondiv>`
which is a subset of functionality now available with `<div>`.

_Originally posted by @robander in
oasis-tcs/dita#397 (comment)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

3 participants