Difference between revisions of "Talk:Introduction to JP Boyd on Family Law"

From Clicklaw Wikibooks
Jump to navigation Jump to search
m
m
Line 1: Line 1:


I would like to see a subsection in the introduction: '''How the information is organized'''. (Think about the print readers as well as online readers for this.)
I have written a brief introduction. See what you think.


This is as good a place as any to identify important organizational issues about headings and sections:


Cross-referencing right now lists the chapter heading (short form) plus the section. There are no links just to a section.  
There are still major challenges:
 
1. '''Names of chapters'''. For some chapters, there is a short title (in the TOC that you can see on the right) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?) Ideally, both for online and print, the name of the chapter heading should be '''exactly''' as it appears in '''any''' direction to it. Otherwise readers will feeling anxious. Right now the readers are looking at the short title in the brief TOC on the right, but when the reader is being '''linked''' in the text the long title is used. It has to be consistent, not puzzling.
 


There are still major challenges:
2. '''Chapters headings doubling as section headings'''.


1. '''Names of chapters'''. For some chapters, there is a short title (in the TOC that you can see on the right) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?) Ideally, both for online and print, the name of the chapter heading should be '''exactly''' as it appears in '''any''' direction to it. Otherwise readers will feeling anxious. Right now the readers are looking at the short title in the brief TOC on the right, but when the reader is being '''linked''' in the text the long title is used. I'm thinking maybe we should revise the "short title" approach (no doubt made to fit in the window) as the "long title" approach appears to be the one that embedded. It has to be consistent, not puzzling.
I have added a sub-heading, Overview, to the start of each chapter. This is not entirely consistent, but it's a compromise. We would need to do a work-around on this in terms of the style sheet, and an auto-generated TOC for the PDF.


The Legal System is really about family law in particular, not the legal system as a whole. I don't think we can get round our problems by having short/long titles.
Here is my thinking about this:


2. '''Chapters headings doubling as section headings'''. At the moment the chapter heading is also de facto the heading of the overview section. This is followed by "more detailed" sections. Logically this bothers me. It should be (a) heading; (b) section/section/section. And in the in-print TOC it will need to look like this.   
In the copy I'm editing, the chapter heading is also de facto the heading of the overview section. This is followed by "more detailed" sections. Logically this bothers me. It should be (a) heading; (b) section/section/section. And in the in-print TOC it will need to look like this.   


The problem then becomes a style sheet one, where each section (aka page) starts with an (a) heading, even though subsequent sections are actually (b) section headings. In an online non-book format, I'd take a heading page, put in the intro, then line up the sections for folks to link to: overview section/more detailed section/more detailed section. (The heading for the overview section could just say "overview."
The problem then becomes a style sheet one, where each section (aka page) starts with an (a) heading, even though subsequent sections are actually (b) section headings. In an online non-book format, I'd take a heading page, put in the intro, then line up the sections for folks to link to: overview section/more detailed section/more detailed section. (The heading for the overview section could just say "overview."
Line 19: Line 22:




4. The links to sections are different from the sections you can see on short TOC. Links to the forms have one name in the document and another in the short TOC.
4. The links to sections (and to forms) are different from the sections you can see on the short TOC.

Revision as of 18:14, 25 April 2013

I have written a brief introduction. See what you think.


There are still major challenges:

1. Names of chapters. For some chapters, there is a short title (in the TOC that you can see on the right) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?) Ideally, both for online and print, the name of the chapter heading should be exactly as it appears in any direction to it. Otherwise readers will feeling anxious. Right now the readers are looking at the short title in the brief TOC on the right, but when the reader is being linked in the text the long title is used. It has to be consistent, not puzzling.


2. Chapters headings doubling as section headings.

I have added a sub-heading, Overview, to the start of each chapter. This is not entirely consistent, but it's a compromise. We would need to do a work-around on this in terms of the style sheet, and an auto-generated TOC for the PDF.

Here is my thinking about this:

In the copy I'm editing, the chapter heading is also de facto the heading of the overview section. This is followed by "more detailed" sections. Logically this bothers me. It should be (a) heading; (b) section/section/section. And in the in-print TOC it will need to look like this.

The problem then becomes a style sheet one, where each section (aka page) starts with an (a) heading, even though subsequent sections are actually (b) section headings. In an online non-book format, I'd take a heading page, put in the intro, then line up the sections for folks to link to: overview section/more detailed section/more detailed section. (The heading for the overview section could just say "overview."

3. In-print TOC. We are having a nice numbered manual, right?


4. The links to sections (and to forms) are different from the sections you can see on the short TOC.

In law, (1) a written argument, or (2) a memorandum of law. A brief is usually presented to a judge as a summary of an argument or the law on a particular issue. Curiously, briefs are rarely brief.

In law, a document demonstrating ownership of a thing. See "ownership."

Retrieved from "https://wiki.clicklaw.bc.ca/index.php?title=Talk:Introduction_to_JP_Boyd_on_Family_Law&oldid=10703"