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

Checklist of ODF 1.3 CS02 Enhancements #21

Closed
31 tasks done
svanteschubert opened this issue Aug 14, 2020 · 6 comments · Fixed by #30
Closed
31 tasks done

Checklist of ODF 1.3 CS02 Enhancements #21

svanteschubert opened this issue Aug 14, 2020 · 6 comments · Fixed by #30
Assignees
Labels
editorial Fix inclues only presentational issue and is not changing any semantic of ODF
Milestone

Comments

@svanteschubert
Copy link
Contributor

svanteschubert commented Aug 14, 2020

  • C1 - Part 2 fixing two references by replacing in XML 'element-dsig:document-signatures' with 'attribute-manifest:version_element-dsig:document-signatures'
  • C2 - Part 2 removing accidental bookmarks 'pp', 'msg15', 'DDE_LINK1'
  • C3 - Part 2 exchanging four instances of 'implementation defined' with 'implemenation-defined' according to Terminology
  • C4 - Part 2: Overriding font-height="100%" with font-height="normal" at our specs root style "Normal"
  • C5 - Part 2: Fixing font color problem in HTML (part 1) by moving "Text Body" back from beyond "Abstract" to beyond "Normal"
  • C6 - Part 2: Fixing font color problem in HTML (part 2) by resolving style hierarchy of title-page styles moving color in extra style
  • C7 - Part 2: Replacing unallowed Text Style "Definition" with correct "Def" character style, see below
  • C8 - Part 2: Added 58 times character style 'ISO Keyword' to 'shall'/'shall not', see below
  • C9 - Part 2: Removed at the end (manually) three none-ODF XML attributes: draw:fill, draw:fill-color, draw:opacity
  • C10 - Part 4: Replacing 'implementation defined' with 'implementation-defined' according to Terminology
  • C11 - Part 1,3,4: Checked 'implementation dependent' with 'implementation-dependent' according to Terminology
  • C12 - Part 1,3,4: Font color and line-heigt adjustments for HTML
  • C13 - Moving ODT-HTML and XML-default-files into docs/odf1.3/ to be viewable with browser!
  • C14 - Part 2: Update reference of broken link: ANSI/NISO Z39.86-2005 (R2012)
  • C15 - Part 4: Update reference of broken link: https://www.iso.org/
  • C16 - Part 1,3,4: Removing at the end (manually) three none-ODF 1.2 XML attributes: draw:fill, draw:fill-color, draw:opacity
  • C17 - Part 3: Updating current default value XML of part3 to /docs directory
  • C18 - Part 1-4: HTML XSLT fix to cover all grey-boxed paragraph border issues
  • C19 - Part 3: HTML XSLT have to use HTTPS reference to MathML (ignored in CS01 in Chrome)
  • C20 - Part 3: HTML using MathML JavaScript, CSS, etc. files from our GitHub Copy
  • C21 - Part 1: Updated TC participants list
  • C22 - Part 1: Removed unused revision chapter
  • C23 - Part 1-4: Fixed Appendix headings in HTML (using h tag instead h1 to h3)
  • C24 - Part 1-4: Fixed Appendix headings removing trailing '.' added indent in between title
  • C25 - Part 1-4: Updated Table of Contents (ToC) manually via LibreOffice
  • C26 - Part 1,2: Table of Content (ToC) was in HTML without chapter numbers
  • C27 - Part 3: Regina found (and I removed) about a dozen duplicated text boxes in the appendices

*** Tasks for OASIS

  • I - Part 1-4: Adding metadata to meta.xml that can be reused by HTML for search engines
  • II - Part 1-4: Exchanged OASIS voting date
  • III - Part 1-4: After a conference call with OASIS updated TC copyright header accordingly
  • IV - Part 1-4: Provided ZIP with all our deliverables at OASIS to vote upon,

Further tasks & issues were moved to ODF 1.4, see #27

Regarding C7: Documentation of allowed styles:
https://github.com/oasis-tcs/odf-tc/blob/master/src/test/resources/odf1.3/tools/How_to_prepare_ODF_specification_documents.md#text-styles

Regarding C8: Test reading is easier for the "shall" setting, by opening the HTML part 2 page and change the background colour of the "ISO Keyword" CSS style using the browser development tool (pressing F12 to open tooling).

Validation:

  • Our ODT deliverable (part 1, 2, 3 and 4) was validated via https://odfvalidator.org/
    Note:
    ODT Part 3 is invalid ODF 1.2 as TC's LibreOffice Version is using negative @fo:padding-top, only non-negative are allowed
    ODT Part 3+4 are indicated as invalid as MathML has no grammar, this might be a validator issue (or LO issue)
  • Our HTML deliverable (part 1, 2, 3 and 4) was checked for broken links via https://www.drlinkcheck.com/
@svanteschubert svanteschubert added the editorial Fix inclues only presentational issue and is not changing any semantic of ODF label Aug 14, 2020
@svanteschubert svanteschubert added this to the ODF 1.3 CS02 milestone Aug 14, 2020
@svanteschubert svanteschubert self-assigned this Aug 14, 2020
@franciscave
Copy link
Contributor

Not only should the text use (and highlight) the ISO keywords correctly, but should avoid alternative words that are deprecated by the ISO/IEC Directives Part 2. Thus, for example, in section 3.7, step 12, the use of “must” in the last sentence is deprecated, so should be replaced by “shall”.

But do we want to check all ISO keywords in Parts 3 Schema and 4 Formula? This is a big task (Patrick and I started work on this some weeks ago) and I would have thought it could be postponed to ODF 1.4.

@pdurusau
Copy link
Contributor

Francis I'm not sure about the highlighting of ISO keywords. The latest version of ISO/IEC Directives Part 2, https://isotc.iso.org/livelink/livelink?func=ll&objId=4230456&objAction=browse&sort=subtype (8th edition), reserves bold for preferred terms. Section 7.

Yes to correctiong "must" in part 2, Section 3.7, step 12; part 3, Annex D, D.3; part 4, 3.4, 11. I didn't find any other uses of must.

@franciscave
Copy link
Contributor

franciscave commented Aug 15, 2020

Patrick, you're right to pick me up on this. I was using the term "highlighting" loosely. What I think is useful - I have found it useful - is to have the ISO keywords styled with the named character style 'ISO Keyword', so that it is easy to find all instances to verify that the terms are being used correctly. I should therefore have said "style" rather than "highlight". I should stress that this does not mean that the ISO keywords would be distinctively styled in typographic terms in the final published text. As you rightly point out, ISO house style in effect forbids this. But don't get me started on ISO house style... [in many respects they're living in the stone age].

@svanteschubert
Copy link
Contributor Author

Seems I am not able to access the ISO/IEC Directives.
You - who have access and are aware of ISO rules - have to be certain that we only "should" highlight and not "shall" highlight.
In general, it would be wise to move only 'allowed' defects to ODF 1.4, otherwise, the cost and time to fix them would only rise for us.

The exchange of words within our normative parts might be able to be automated, but I agree we should move as much as possible into ODF 1.4.

@franciscave
Copy link
Contributor

The ISO/IEC Directives and other related resources can be found here.

ISO are less strict with PAS submissions than they are with standards developed by ISO and IEC committees. The current specifications are pretty close.

@svanteschubert
Copy link
Contributor Author

svanteschubert commented Aug 15, 2020 via email

@svanteschubert svanteschubert changed the title Minor editorial issues for ODF 1.3 CS02 Checklist of ODF 1.3 CS02 Enhancements Aug 17, 2020
@svanteschubert svanteschubert changed the title Checklist of ODF 1.3 CS02 Enhancements Checklist of ODF 1.3 CS03 Enhancements Aug 24, 2020
@svanteschubert svanteschubert changed the title Checklist of ODF 1.3 CS03 Enhancements Checklist of ODF 1.3 CS02 Enhancements Oct 9, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editorial Fix inclues only presentational issue and is not changing any semantic of ODF
Projects
None yet
3 participants