[alreq] Structure of the document (#211)

TitusNemeth has just created a new issue for https://github.com/w3c/alreq:

== Structure of the document ==
Following up from my last PR, I reviewed again the structure of the document and found some items that could possibly be arranged more fittingly. Below is a suggested draft TOC for discussion. 

I have generally sought to follow as much as possible Richard's template here https://w3c.github.io/typography/
One general remark is that in ALREQ we have a sometimes exaggerated use of subsections, which could be folded into the paragraph one hierarchy further up. I have done this with the sub-subsections of the introduction, but I think it could be done elsewhere too. I don't think this number of levels always contributes to improved clarity.

The main change that I've introduced is the reorganisation of the 'Arabic Script Overview', which I have renamed as 'Characteristics of the Arabic script'. Here I have renamed the section 'Typography' as 'Fundamental principles' (where some things should still be added), because its subsections are not typographic, but relate to features of the script. Also the section 'Fonts' does not belong to a description of the script per se, but should be discussed elsewhere – here I have followed Richard's template document and sorted them under 'Characters & phrases'. 

Finally I have introduced a section 'Typography', which is what Richard's document calls 'Layout and pages'. Since layout also includes image placement and everything related to that, I felt that it would be better to stick to 'Typography' when discussing just text organisation. The subsection 'Considerations for mixed-script text' should probably be put here, and merits fleshing out.

I am sure there may be other sections or subsections that could be shifted, but I'll leave it at this for the moment so that things remain manageable.


1. Introduction
1.1. Gap Analysis
1.2. Other Related Resources
1.3. Language limitation

2. Characteristics of the Arabic script
2.1. Fundamental principles
2.1.1. Multi-level baselines
2.1.2. Multi-context joining
2.1.3. Words as groups of letters
2.1.4. Vertical joining
2.1.5. The so-called teeth letters
2.2. The Islamic manuscript tradition
2.2.1. Origins
2.2.2. Writing Styles

3. Characters & phrases
3.1. Characters & encoding
3.2. Fonts
3.3. Direction
3.4. Joining
3.4.1. Joining Forms
3.4.2. Joining Categories
3.4.3. Joining Rules
3.4.4. Joining Control
3.4.4.1. Disjoining Enforcement
3.4.4.2. Joining Enforcement
3.4.4.3. Joining-Disjoining Enforcement
3.4.4.4. Context-Based Joining
3.4.5. Joining Segments
3.4.5.1. Closed Joining Segments
3.4.5.2. Open Joining Segments
3.4.6. Non-Joining Characters
3.5. Text Segmentation
3.6. Positioning diacritics relative to base characters
3.7. Letter-spacing
3.8. Special requirements when dealing with cursive glyphs
3.8.1. Joining and Intra-Word Spaces
3.8.2. Transparency
3.8.3. Text border
3.8.4. Styling individual letters
3.9. Numbers
3.9.1. Preferred Terminology
3.9.2. Families of Numerals
3.9.3. Formatting of Numerals
3.9.4. Arabic number in other uses

4. Lines and paragraphs
4.1. Line breaking
4.2. Justification 
4.2.1. Adjusting Inter-Word Spaces
4.2.2. Adjusting Intra-Word Spaces
4.2.3. Alternative Shapes
4.2.4. Ligatures
4.2.5. Kashida
4.2.6. Tatweel
4.2.7. Combination of the Mechanisms

5. Typography
5.1. General text layout and progression
5.2. Paragraph and line alignment
5.3. Considerations for mixed-script text
5.4. Counters, lists, etc
5.5. Special cases
5.5.1. Vertical text
5.5.1.1. Arabic embedded in vertically orientated text
5.5.1.2. Upright vertical Arabic text

Appendices
A. Characters
A.1 Alphabetical characters
A.2 Diacritics
A.3 Numeral characters
A.4 Punctuations and symbols
A.5 Control characters
B. Glossary


Please view or discuss this issue at https://github.com/w3c/alreq/issues/211 using your GitHub account

Received on Wednesday, 22 January 2020 09:35:16 UTC