Technical Advisory Board (TAB)

 View Only
  • 1.  Hanging paragraphs

    Posted 08-14-2015 19:55
    Chet, Kevin and I had a useful exchange on hanging paragraphs and their presence in the templates delivered to TCs for new work. Could you or Paul correct the templates and perhaps even mention that: Chapter - Heading Section:1 <text goes here> Section:2 Section 2.1 <text goes here> Section 2.2 is an example of how to organize their materials? Thanks! Hope you are looking forward to a great weekend! Patrick PS: I can write up correct/incorrect examples as images if that would help. -- Patrick Durusau patrick@durusau.net Technical Advisory Board, OASIS (TAB) OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300 Co-Editor 13250-5 (Topic Maps) Another Word For It (blog): http://tm.durusau.net Homepage: http://www.durusau.net Twitter: patrickDurusau


  • 2.  Re: Hanging paragraphs

    Posted 08-14-2015 20:41
    Hi Patrick - sure, we can do that. Some examples would help. I'm not clear on the exact problem.  /chet On Fri, Aug 14, 2015 at 3:55 PM, Patrick Durusau < patrick@durusau.net > wrote: Chet, Kevin and I had a useful exchange on hanging paragraphs and their presence in the templates delivered to TCs for new work. Could you or Paul correct the templates and perhaps even mention that: Chapter - Heading Section:1 <text goes here> Section:2 Section 2.1 <text goes here> Section 2.2 is an example of how to organize their materials? Thanks! Hope you are looking forward to a great weekend! Patrick PS: I can write up correct/incorrect examples as images if that would help. -- Patrick Durusau patrick@durusau.net Technical Advisory Board, OASIS (TAB) OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300 Co-Editor 13250-5 (Topic Maps) Another Word For It (blog): http://tm.durusau.net Homepage: http://www.durusau.net Twitter: patrickDurusau -- /chet  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393 


  • 3.  Re: Hanging paragraphs

    Posted 08-14-2015 21:09
    Chet, You must not be reading my comments very closely. ;-) A hanging paragraph is a paragraph that follows a heading that is followed by a sub-heading. Thus: Incorrect: Chapter 1. How to Spot a Hanging Paragraph This chapter covers hanging paragraphs and why they are a problem in standards writing. 1.1 Hanging Paragraphs and Ambiguous References If I say, see Chapter 1, do I mean all of chapter 1? Or do I mean look at: This chapter covers hanging paragraphs and why they are a problem in standards writing. You see, the paragraph (and any following Chapter 1 but before 1.1, are hanging paragraphs. There is no way for me to cite them other than by saying, Chapter 1. I may want to say Chapter 1 and mean all of chapter 1. Can't do either one with hanging paragraphs. Hence the definition: A hanging paragraph is a paragraph that follows a heading that is followed by a sub-heading. Correct: Chapter 1. How to Spot a Hanging Paragraph 1.1 Introduction This chapter covers hanging paragraphs and why they are a problem in standards writing. 1.2 Hanging Paragraphs and Ambiguous References If I say, see 1.1 Introduction, the paragraph that follows 1.1 is no longer a hanging paragraph and I can reference it, or I can reference all of Chapter 1, by saying see Chapter 1. Do you see the difference now? It really makes a difference when you want to mix normative and non-normative prose because you can say: All introductions are informal and non-normative, followed by normative text unless otherwise marked. The same thing happens with deeply nests sub-sections as well. Does that help? Hope you are at the start of a great weekend! Patrick On 08/14/2015 04:40 PM, Chet Ensign wrote: Hi Patrick - sure, we can do that. Some examples would help. I'm not clear on the exact problem.  /chet On Fri, Aug 14, 2015 at 3:55 PM, Patrick Durusau < patrick@durusau.net > wrote: Chet, Kevin and I had a useful exchange on hanging paragraphs and their presence in the templates delivered to TCs for new work. Could you or Paul correct the templates and perhaps even mention that: Chapter - Heading Section:1 <text goes here> Section:2 Section 2.1 <text goes here> Section 2.2 is an example of how to organize their materials? Thanks! Hope you are looking forward to a great weekend! Patrick PS: I can write up correct/incorrect examples as images if that would help. -- Patrick Durusau patrick@durusau.net Technical Advisory Board, OASIS (TAB) OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300 Co-Editor 13250-5 (Topic Maps) Another Word For It (blog): http://tm.durusau.net Homepage: http://www.durusau.net Twitter: patrickDurusau -- /chet  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393  -- Patrick Durusau patrick@durusau.net Technical Advisory Board, OASIS (TAB) OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300 Co-Editor 13250-5 (Topic Maps) Another Word For It (blog): http://tm.durusau.net Homepage: http://www.durusau.net Twitter: patrickDurusau


  • 4.  Re: Hanging paragraphs

    Posted 08-14-2015 21:13
    Yes thanks. We'll go ahead and make that adjustment to the templates.  /chet On Fri, Aug 14, 2015 at 5:08 PM, Patrick Durusau < patrick@durusau.net > wrote: Chet, You must not be reading my comments very closely. ;-) A hanging paragraph is a paragraph that follows a heading that is followed by a sub-heading. Thus: Incorrect: Chapter 1. How to Spot a Hanging Paragraph This chapter covers hanging paragraphs and why they are a problem in standards writing. 1.1 Hanging Paragraphs and Ambiguous References If I say, see Chapter 1, do I mean all of chapter 1? Or do I mean look at: "This chapter covers hanging paragraphs and why they are a problem in standards writing." You see, the paragraph (and any following Chapter 1 but before 1.1, are hanging paragraphs. There is no way for me to cite them other than by saying, Chapter 1. I may want to say Chapter 1 and mean all of chapter 1. Can't do either one with hanging paragraphs. Hence the definition: A hanging paragraph is a paragraph that follows a heading that is followed by a sub-heading. Correct: Chapter 1. How to Spot a Hanging Paragraph 1.1 Introduction This chapter covers hanging paragraphs and why they are a problem in standards writing. 1.2 Hanging Paragraphs and Ambiguous References If I say, see 1.1 Introduction, the paragraph that follows 1.1 is no longer a hanging paragraph and I can reference it, or I can reference all of Chapter 1, by saying see Chapter 1. Do you see the difference now? It really makes a difference when you want to mix normative and non-normative prose because you can say: All introductions are informal and non-normative, followed by normative text unless otherwise marked. The same thing happens with deeply nests sub-sections as well. Does that help? Hope you are at the start of a great weekend! Patrick On 08/14/2015 04:40 PM, Chet Ensign wrote: Hi Patrick - sure, we can do that. Some examples would help. I'm not clear on the exact problem.  /chet On Fri, Aug 14, 2015 at 3:55 PM, Patrick Durusau < patrick@durusau.net > wrote: Chet, Kevin and I had a useful exchange on hanging paragraphs and their presence in the templates delivered to TCs for new work. Could you or Paul correct the templates and perhaps even mention that: Chapter - Heading Section:1 <text goes here> Section:2 Section 2.1 <text goes here> Section 2.2 is an example of how to organize their materials? Thanks! Hope you are looking forward to a great weekend! Patrick PS: I can write up correct/incorrect examples as images if that would help. -- Patrick Durusau patrick@durusau.net Technical Advisory Board, OASIS (TAB) OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300 Co-Editor 13250-5 (Topic Maps) Another Word For It (blog): http://tm.durusau.net Homepage: http://www.durusau.net Twitter: patrickDurusau -- /chet  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393   -- Patrick Durusau patrick@durusau.net Technical Advisory Board, OASIS (TAB) OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300 Co-Editor 13250-5 (Topic Maps) Another Word For It (blog): http://tm.durusau.net Homepage: http://www.durusau.net Twitter: patrickDurusau -- /chet  ---------------- Chet Ensign Director of Standards Development and TC Administration  OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393