Talk:Introduction to JP Boyd on Family Law - Revision history

Gayla Reid: /* Chapters headings doubling as section headings */

2013-05-02T00:54:48Z

Chapters headings doubling as section headings

← Older revision		Revision as of 00:54, 2 May 2013
Line 21:		Line 21:
	The problem then becomes a style sheet headache, 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 headache, 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."

	In the "long toc," which you see when you open initially, you can easily get the impression that there is nothing in that heading, especially when you get something like "basic principles" as a section.

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

Gayla Reid at 01:57, 1 May 2013

2013-05-01T01:57:45Z

← Older revision		Revision as of 01:57, 1 May 2013
Line 49:		Line 49:

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

			==Creative commons==
			I added the rev. edition of the Creative Commons credit at the end of pages, but it has an ugly last line (darts out flush left).
			[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 18:57, 30 April 2013 (PDT)

Gayla Reid: /* Forms */

2013-04-30T23:42:21Z

Forms

← Older revision		Revision as of 23:42, 30 April 2013
Line 46:		Line 46:

	==Forms==		==Forms==
	The "short toc" has a name for the forms sections. When you get there it is something different - and it's ''very'' legalese. Something like: Supreme Court forms (family law). Can we get rid of ~~having~~ those parentheses?		The "short toc" has a name for the forms sections. When you get there it is something different - and it's ''very'' legalese. Something like: Supreme Court forms (family law). Can we get rid of those parentheses? (The short TOC for the forms is good, in my opinion.)

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

Gayla Reid: /* In-print TOC */

2013-04-30T23:41:43Z

In-print TOC

← Older revision		Revision as of 23:41, 30 April 2013
Line 44:		Line 44:

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)


	==Forms==		==Forms==

Gayla Reid: /* Names of chapters and sections */

2013-04-30T23:41:24Z

Names of chapters and sections

← Older revision		Revision as of 23:41, 30 April 2013
Line 27:		Line 27:
	==Names of chapters and sections==		==Names of chapters and sections==

	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 start feeling anxious.		Ideally, both for online and print, the names of the chapter and section headings should be '''exactly''' as it appears in '''any''' direction to it. Otherwise readers will start feeling anxious. (They know it's a minefield.)

	For some chapters, there is a short title (in the TOC that you can see on the right when you have selected a chapter) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?)		For some chapters, there is a short title (in the TOC that you can see on the right when you have selected a chapter) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?)

	Some links were using the short titles, but of course the longer title was showing up at the destinations. I changed this so that the link is the longer title - just to be consistent. (But in some cases (see comment on forms, below) I think the short title is the better one.		Some links were using the short titles, but of course the longer title was showing up at the destinations. I changed this so that the link is the longer title - just to be consistent. (But in some cases (see comment on forms, below) I think the short title is the better one. Suggestions?

	==The "short" TOC==		==The "short" TOC==

Gayla Reid: /* Chapters headings doubling as section headings */

2013-04-30T23:40:08Z

Chapters headings doubling as section headings

← Older revision		Revision as of 23:40, 30 April 2013
Line 21:		Line 21:
	The problem then becomes a style sheet headache, 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 headache, 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."

	In the "long toc," which you see when you open initially,you can easily get the impression that there is nothing in that heading especially when you get something like "basic principles" as a section.		In the "long toc," which you see when you open initially, you can easily get the impression that there is nothing in that heading, especially when you get something like "basic principles" as a section.

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

Gayla Reid: /* SHORT TOC */

2013-04-30T23:39:26Z

SHORT TOC

← Older revision		Revision as of 23:39, 30 April 2013
Line 33:		Line 33:
	Some links were using the short titles, but of course the longer title was showing up at the destinations. I changed this so that the link is the longer title - just to be consistent. (But in some cases (see comment on forms, below) I think the short title is the better one.		Some links were using the short titles, but of course the longer title was showing up at the destinations. I changed this so that the link is the longer title - just to be consistent. (But in some cases (see comment on forms, below) I think the short title is the better one.

	==~~SHORT~~ TOC==		==The "short" TOC==

			Right now the readers are looking at the short title in the brief TOC on the right but seeing a longer title in the link and at the destination. Consistency is important.

	Right now the readers are looking at the short title in the brief TOC on the right but seeing a longer title in the link and at the destination. I'm not sure what we can do about this, but consistency is important. (Readers know that legal stuff is a minefield.)

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)


	==In-print TOC==		==In-print TOC==

Gayla Reid: /* Forms */

2013-04-30T23:38:48Z

Forms

← Older revision		Revision as of 23:38, 30 April 2013
Line 48:		Line 48:

	==Forms==		==Forms==
	The "short toc" has a name for the forms sections. When you get there it is something different - and it's very legalese. Something like: Supreme Court forms (family law). Can we get rid of having ~~that in~~ parentheses? ~~Just use the "short toc" titles.~~		The "short toc" has a name for the forms sections. When you get there it is something different - and it's ''very'' legalese. Something like: Supreme Court forms (family law). Can we get rid of having those parentheses?

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

Gayla Reid: /* Names of chapters and sections */

2013-04-30T23:37:40Z

Names of chapters and sections

← Older revision		Revision as of 23:37, 30 April 2013
Line 31:		Line 31:
	For some chapters, there is a short title (in the TOC that you can see on the right when you have selected a chapter) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?)		For some chapters, there is a short title (in the TOC that you can see on the right when you have selected a chapter) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?)

	Some links were using the short titles, but of course the longer title was showing up at the destinations. I changed this so that the link is the longer title - just to be consistent.		Some links were using the short titles, but of course the longer title was showing up at the destinations. I changed this so that the link is the longer title - just to be consistent. (But in some cases (see comment on forms, below) I think the short title is the better one.

	==SHORT TOC==		==SHORT TOC==

Gayla Reid at 23:35, 30 April 2013

2013-04-30T23:35:21Z

← Older revision		Revision as of 23:35, 30 April 2013
Line 1:		Line 1:

			==Introduction==
	I have written a brief introduction to this introduction. Also added a sentence or two to the existing copy in the following paragraph. I focus on JP rather than on the "team" because the great strength of this material is the feeling you get of his voice. See what you think.		I have written a brief introduction to this introduction. Also added a sentence or two to the existing copy in the following paragraph. I focus on JP rather than on the "team" because the great strength of this material is the feeling you get of his voice. See what you think.

Line 6:		Line 7:
	We would need to tell users where they can get the PDF and where to go online. Put it in a box. Bold.		We would need to tell users where they can get the PDF and where to go online. Put it in a box. Bold.

	~~==Structure==~~		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

	~~A few structural challenges:~~

	~~1. '''~~Chapters headings doubling as section headings~~'''.~~
			==Chapters headings doubling as section headings==

	I strongly recommend adding a sub-heading, '''Overview''', to the start of each chapter (following the chapter's introduction).		I strongly recommend adding a sub-heading, '''Overview''', to the start of each chapter (following the chapter's introduction).
Line 22:		Line 23:
	In the "long toc," which you see when you open initially,you can easily get the impression that there is nothing in that heading especially when you get something like "basic principles" as a section.		In the "long toc," which you see when you open initially,you can easily get the impression that there is nothing in that heading especially when you get something like "basic principles" as a section.

	2. '''~~Names of chapters~~'''. For some chapters, there is a short title (in the TOC that you can see on the right when you have selected a chapter) and a longer title when you arrive at the destination. This creates uncertainty when you link internally (am I in the right place?)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

			==Names of chapters and sections==

			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 start feeling anxious.

			For some chapters, there is a short title (in the TOC that you can see on the right when you have selected a chapter) 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~~.		Some links were using the short titles, but of course the longer title was showing up at the destinations. I changed this so that the link is the longer title - just to be consistent.

	~~Otherwise readers will start 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. (~~I ~~don~~'~~t care if long or short titles are used~~, but ~~only one title would be~~ a ~~grand idea~~.)		==SHORT TOC==

			Right now the readers are looking at the short title in the brief TOC on the right but seeing a longer title in the link and at the destination. I'm not sure what we can do about this, but consistency is important. (Readers know that legal stuff is a minefield.)

			[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)

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

			==In-print TOC==

	~~4. The links to sections (and to forms)~~ are ~~sometimes different from the sections you can see on the short TOC. They are consistent when you~~ get ~~there~~. (~~This again is a short TOC issue rather than a linking issues~~.)		We are having a nice numbered manual, right? It will help readers get around, given that they won't have hyperlinks. (I wouldn't want it online.)

	[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)		[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)


	5. The "short toc" ~~links to~~ forms ~~in a useful and clear way~~. ~~But when~~ you get ~~to the forms they have that~~ very legalese ~~heading with parentheses~~: Supreme Court forms (family law) ~~or words to that effect~~. Can we get rid of the (~~family law~~) ~~format?~~		==Forms==
			The "short toc" has a name for the forms sections. When you get there it is something different - and it's very legalese. Something like: Supreme Court forms (family law). Can we get rid of having that in parentheses? Just use the "short toc" titles.

			[[User:Gayla Reid\|Gayla Reid]] ([[User talk:Gayla Reid\|talk]]) 16:26, 30 April 2013 (PDT)