Re: [clreq] Restructure clreq per standardised headings (#629)

Reading the minutes, it seems like it would be useful for me to attend the next telecon to answer questions.

In the meantime, here are some pointers that may help.

1. The organisation of material is driven by _function_ rather than appearance/techniques used, ie. what message the author is attempting to convey, rather than how they do it.  So, for example, underlining of text may be described under Text Emphasis for many languages, but belongs under Quotations & Citations when we are dealing with book title underlines in Chinese. This, for example, is why some of the punctuation related information is split into different sections – what the author is trying to achieve is more more important in determining the organisation of material than the fact that these are all punctuation marks.
2. I agreed to separate out the Interaction section from Page & Book Layout because i considered it a tweak that doesn't significantly change the order or segmentation of the data.  In general, however, the headings listed in https://github.com/w3c/clreq/issues/629#issuecomment-2270501142 are the things that provide harmonisation and consistency with all the other materials in the lreq framework.  Changing them breaks that link and reduces the benefits of adopting the standard toc.  On the other hand, the content subsections within those sections can be whatever is preferred, and are the things that are likely to change from language to language when this template is used.
3. I developed the headings in this template over many years while developing a standard approach to describe 90 different orthographies from all around the world.  The focus on the content author's intention, rather than the techniques used, helps to ensure that the template fits well for all of those orthographies. Using the standard template across these orthographies makes it easy to find and compare information across those very different orthographies.

Btw, i fixed the sectioning bug so that baselines, lists, and initials now all fall under Line & Paragraph Layout, as they should.

-- 
GitHub Notification of comment by r12a
Please view or discuss this issue at https://github.com/w3c/clreq/issues/629#issuecomment-2277331284 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Friday, 9 August 2024 07:30:33 UTC