Wikipedia talk:Layout

This MedLibrary.org supplementary page on Wikipedia talk:Layout is provided directly from the open source Wikipedia as a service to our readers. Please see the note below on authorship of this content, as well as the Wikipedia usage guidelines. To search for other content from our encyclopedia supplement, please use the form below:

Archive
Layout/Archives
Editors should feel free to revive a discussion topic from the archive.
Shortcut:
WT:GTL

Contents

Clearing up "Notes," "References," and "Notes and References"

What is the preferred approach?

I am still blundering toward an understanding of the proper use of the “Notes,” “References,” and “Notes and References” sections. Are the following statements correct? If not, what should be changed to make them correct?

1. The References section should contain only full citations to source material.
2. Citations in the References section may appear in an alphabetized list (Flags of Canada for example) or a linked list (Jane Austen for example), but not both. (If this is wrong then should the two lists appear in separate sections? And, if they should, what is the name of each such section?)
3. The Notes section should contain only comments on the text (which may be supported by short citations to materials listed with full citations in the References section).
4. Articles should contain citations to source material (“References”) and may contain comments (“Notes”).
5. The References section my precede the Notes section, or vice versa.
6. Generally, if an article contains both citations (“References”) and comments (“Notes”) then they should appear in separate sections. However, if an article contains only a few citations and a few comments then they can be combined in a “Notes and References” section.

Butwhatdoiknow (talk) 11:53, 30 June 2008 (UTC)

1. Looks right. 2. Looks right. 3. Looks right, but not written very clearly. 4. Don't know what it's trying to say, but looks wrong, unclear. 5. Correct except for the typo (my --> may). 6. Looks right. SandyGeorgia (Talk) 17:27, 30 June 2008 (UTC)
(1) is wrong. Yes, ==References== should always have a full citation to the source. However, it also permits the inclusion of short-form citations such as "Everyman, J., page 157." after the long-form citation. See History of condoms#References and Jane Austen#References for two very clear examples of what I'm talking about, and Acute myeloid leukemia#References for an example in an FA-class article (search for Abeloff in the refs). Also, pushing for separate sections is going to result in stupid-looking articles, with people listing every single reference in both sections because it's "required" by WP:LAY, even if the reference is only used once.
(2) has a very poor example: there is only one reference listed in Flags of Canada. A list of one item cannot usefully be said to be alphabetized. However, what's relevant is that references using <ref> automatically appear in the order in which they are linked. Full references using Harvard style (author-date style) should be alphabetized. A list of short citations (for page numbers) is inappropriate in Harvard style, because the author-date style is actually the author-date-page number style. We can simply reassert that each article must use a consistent style for its references and leave it at that. (Because if they use one style or the other, this problem won't come up.)
(3) might be profitably expanded to include quotations from the source text, to keep it consistent with Wikipedia:Cite sources#What footnotes are used for.
(4) makes sense to me. It attempts to distinguish between a reference (You Must Cite Your Sources) and explanatory text (Avoid Long Parenthetical Explanations in the Middle of the Article).
(5) is probably not best practice. ==Notes== or ==Footnotes== might contain on-Wiki information and thus precedes ==References==, which should always contain off-Wiki information. Furthermore, the reader might actually need to read the notes to understand the text. Therefore ==Notes== always precedes ==References==.
(6) is right.
Now I'd like you to consider the inherent contradiction in what you've just written: Your (1) says that ==References== must only have full citations. Your (3) says that ==Notes== must only contain comments. Where do you expect to put the short citations (page numbers from a book you've used repeatedly)? WhatamIdoing (talk) 19:36, 30 June 2008 (UTC)

Thanks for the help. The following list is better (I hope), but can no doubt be improved. Please let me know what still needs work to make the following statements correct.

1. The References section should contain only citations to source material.
2. Citations in the References section may appear in a Harvard-style alphabetized list (Starship Troopers for example) or a <ref> linked list (Jane Austen for example), but not both.
3. If the <ref> approach is used in the References section then the Notes section should contain only comments on the text or quotes from source materials (either of which may be supported by short citations to materials listed with full citations in the References section). If the Harvard-style approach is used then the Notes section may also contain short citations on their own.
4. Articles should be supported by citations to source material (“References”) and may also contain explanatory comments (“Notes”).
5. The Notes section should precede the References section.
6. Generally, if an article contains both citations (“References”) and comments (“Notes”) then they should appear in separate sections. However, if an article contains only a few citations and a few comments then they can be combined in a “Notes and References” section.

Butwhatdoiknow (talk) 01:00, 4 July 2008 (UTC)

I think this is generally so in intent, but not in practice. SchmuckyTheCat (talk)
Leaving aside editor compliance for the moment, it looks good to me except for (3), which is wrong: Harvard does not use short citations in footnotes. The Harvard equivalent of the short citation footnote "Everyman, J. (2008), page 157." is the inline notation (Everyman 2008:157). Harvard therefore only puts commentary and quotations in the ==Notes== section (although, reasonably enough, a quotation might be followed by an appropriate Harvard-style inline notation about the page number or other source for the quote). The <ref> system might place short citations in the ==Notes== section (although I personally dislike that approach). You might re-phrase like this:
3. In the Harvard style, the Notes section contains only comments on the text or relevant quotations from source material. In the <ref> approach, the Notes section should contain comments on the text and quotations from source materials and may contain short citations for page numbers if editors prefer to list only full-length citations in the References section.
There may be a better way to phrase it, but this seems reasonably clear to me. Also, it might be worth adding a note about the third section, ==Footnotes==. A Footnotes section is used (only) in the <ref> style when there are many explanatory comments (==Notes==), many short citations (==Footnotes==) and a desire to keep the short citations out of the main list of ==References==. There should be no need for a Footnotes section in the Harvard system. WhatamIdoing (talk) 18:20, 5 July 2008 (UTC)
In practice I don't think any such specific rules are followed. "References" may describe any section containing either citation footnotes or an alphabetized list of sources. "Notes" or "Footnotes" may be used for any section containing footnotes of any type (citations or explanatory footnotes). It is not generally true that citations and explanatory footnotes "should" appear in different sections; indeed, normally they do not, and they may be combined under the headings "Notes", "Footnotes", "Notes and References", etc. Christopher Parham (talk) 19:09, 5 July 2008 (UTC)
I certainly agree with the first sentence. The question is whether there should be a "best practices" guide that we encourage editors to use. That question is discussed below. Butwhatdoiknow (talk) 21:03, 5 July 2008 (UTC)

O.K., I think I'm pretty close now. How's this:

1. The References section should contain only citations to source material.
2. Citations in the References section may appear in a Harvard-style alphabetized list (Starship Troopers for example) or a <ref> linked list (Jane Austen for example), but not both.
3. If the Harvard-style approach is used then the Notes section should contain only comments on the text or relevant quotations from source material. If the <ref> approach is used then the Notes section may also contain, in addition to comments on the text and quotations from source materials, short citations to materials with full-length citations in the References section.
4. Articles should be supported by citations to source material (“References”) and may also contain explanatory comments (“Notes”).
5. The Notes section should precede the References section.
6. Generally, if an article contains both citations (“References”) and comments (“Notes”) then they should appear in separate sections. However, if an article contains only a few citations and a few comments then they can be combined in a “Notes and References” section.

Butwhatdoiknow (talk) 23:20, 10 July 2008 (UTC)

Yes. Now have you considered the use of ==Footnotes== in the <ref> style? It's used on occasion to keep short citations separate from both full references and commentary. WhatamIdoing (talk) 03:20, 11 July 2008 (UTC)
Thanks. I'll add that to my next go-round. Butwhatdoiknow (talk) 22:05, 12 July 2008 (UTC)
(2) is inaccurate; some articles combine general references and citations under one section and nothing currently discourages this. In fact {{reflist}} is specifically designed to enable it. (3) is inaccurate; the Notes section may also contain full-length citations in that situation. (5) is more generally incorrect; Notes and References may appear in either order under the current guideline and neither is preferred. (6) is also not correct; it is not generally true that articles which contain both citations and comments should separate them. (1) and (4) are correct as I understand them, although the section titles indicated by (4) are simply one choice each from multiple options. (1) also needs to be understood broadly, as the section may contain other reference-related material, for instance comments on sources being cited. Christopher Parham (talk) 18:33, 12 July 2008 (UTC)
Thanks. A few follow up questions -
1. Regarding "comments on references," I think I know what you mean but I want to be sure. Can you tell me more about that? (Or, perhaps, just provide a link to an article where this is done.)
2. So if I take out the "but not both" language then 2 would be correct? (Even if that does fix it I would appreciate it if you would provide a sample article where this is done.)
3. I'm a bit lost on this one. If the Notes section contains full citations then shouldn't it be called a "Notes and references" section? I am probably missing something; if so then I appreciate in advance your patience in explaining this to me in more detail.
4. Are the "multiple options" equally preferred from an editorial perspective? If so, please provide me the principal additional alternative names for "References" and "Notes" sections. If not, would you agree that "Notes" and "References" are the titles we should be encouraging?
5. The first time I wrote 5 I said, The References section my precede the Notes section, or vice versa. I was told that this was wrong because, as the Layout article says, Any section which concerns material outside Wikipedia (including References, Bibliography, and External links) should come after any section that concerns Wikipedia material (including See also) to help keep the distinction clear. On the other hand, now that you mention it, I note that Wikipedia:Manual of Style#Section management says they can be reversed. So I'll go with your change on my next go-round.
6. How about: If an article contains both citations and comments then they may appear separately (citations in a "References" section and comments in a "Notes" section) or together (in a "Notes and references" section)?
Butwhatdoiknow (talk) 22:05, 12 July 2008 (UTC)
(1) Well, for instance, an article might present a list of general references with a brief description of what is in particular works. For instance, in an article on a famous building, one might note that one book focuses on the process of construction, one book contains large color architectural drawings, etc., which can help direct readers to the most appropriate source.
(2) The example article given at {{reflist}} is Elephant.
(3) See Rosa Parks; here the cite.php elements appear under "Notes" but contain the full citations.
(4) "Notes" can be called "Footnotes", "Citations", etc. See Pericles, which has "Notes", "Citations" and "References" sections. To my knowledge there is no developed editorial preferences for the names of these sections, and personally I see no value in us encouraging any particular names for these sections.
(6) They may also appear together simply as "Notes", or separately with different section names, as at Pericles. Christopher Parham (talk) 22:27, 12 July 2008 (UTC)
Actually, Christopher, per WP:CITE#HOW, Harvard and inline ref styles should not be mixed, so "but not both" is accurate. The list here does not yet address the use of a general reference in an article that also uses inline refs. WhatamIdoing (talk) 16:17, 13 July 2008 (UTC)
If you are making a distinction between a "citation" and a "general reference" then I think it is fine, but I don't believe that this distinction is made generally across the relevant guidelines (CITE: "This guideline uses the terms "source", "reference", and "citation" interchangeably"). I still think it is a bit misleading, in that a section may contain both an alphabetized list of references (perhaps identical to that found in Harvard style) and footnotes produced by cite.php or another method. However, I agree that parenthetical citation and footnote citation should not be intermingled. Christopher Parham (talk) 19:14, 13 July 2008 (UTC)
References and Notes. If the "Notes" section is being used for short-form citations, then it should come after the full-title citation, so after the "References" section. Jheald (talk) 13:37, 15 July 2008 (UTC)
Please don't cap talk pages; it invalidates future archive searches. If the page is too long, you can archive. SandyGeorgia (Talk) 04:17, 1 August 2008 (UTC)
On the other hand, caping a lengthy discussion enhances the readability of the page before it is archived. Is there any problem with considering this cap to be temporary while the discussion is active? Once the discussion is complete, and the section is qued for archiving, then the cap can be removed. That seems to be the best of both worlds. Butwhatdoiknow (talk) 12:00, 1 August 2008 (UTC)

Back to the drawing board

O.k., back to the drawing board:

1. Articles should be supported by citations to source material (“citations”) and may also contain explanatory comments (“comments”).
2. There is no consensus establishing a particular layout or set of layouts for the presentation of citations and comments. Similarly, there is no consensus establishing the names of the sections into which citations and comments are put.
3. Approaches for presenting citations and comments found in featured articles include:
3.a. Putting linked short citations in a “Notes” section followed by a list of full citations in a “References” section. See, e.g., Starship Troopers (this article has no comments). (A variation on this approach is to put linked short and full citations in a “Notes” section followed by a list of additional full citations in a “References” section as in Palazzo Pitti.)
3.b. Putting linked comments in a “Notes” section, followed by linked short citations in a “References” section, followed by a list of full citations in a “Bibliography” section. See, e.g., Jane Austen. (A variation on this approach is to name the last two sections "Citations" and "References" as in Pericles).
3.c. Putting linked full citations in a “Notes” section, followed by a list of full citations in a “References” section. See, e.g., Rosa Parks (this article has no comments). (Or reversing the order of presentation, as in Absinthe.)
4. In addition, particularly for articles with fewer citations and comments, the citations and comments may be combined in a “Notes and references” section.

Is this any closer to correct? Butwhatdoiknow (talk) 00:16, 22 July 2008 (UTC)

I'm sorry if this increases partisan. However here is another method referencing method, which I am proposing or reproposing:
  1. Providing a "Footnotes" or "Notes" simultaneously with a "References" or occasionally "Bibliography" as a second-level-header (h2):
    1. Over distinguishes the two sections, which present essentially the same content: information that either help verify or elaborate portions that cannot be done from within the article
    2. Increases h2 clutter; which should be reserved for the primary elements of the article
  2. I suggest encapsulating the two as a single h2 likely named "References" with two tertiary-level-headers (h3) named: (1) "Footnotes" or "Notes", and (2)"Bibliography" or "Sources"
  3. If only (1) in-line citations or (2) general references are used, all h3 within the h2 are omitted: leaving only the h2 "References"
  4. In long articles where books or other media are cited more than once from different locations from within the book or media, the "Bibliography" or "Sources" h3 should contain the full citation of the book(s) or other media, with the "Notes" or "Footnotes" h3 containing the relevant locations within them
  5. Explanatory notes and in-line citation can be placed in the same section, however like in the Jane Austen case, it's possible to separate them
This method is outline oriented, which is optimized for the TOC. It does, however, increase the number of sections from potentially two to three. We might not have a consensus on a singular method, but we can consent on what progress we've made.
Here is an example of the proposed method: Link. ChyranandChloe (talk) 02:53, 22 July 2008 (UTC)
As things currently stand (as I understand them) your proposal is as acceptable as any other method. So feel free to implement it on any article you choose to edit. (Keeping in mind that established articles should not be modified simply to make them more acceptable to one editor's sense of aesthetics.) Butwhatdoiknow (talk) 03:08, 22 July 2008 (UTC)
CC, Both bibliography and sources have been deprecated in the past because they seem to be confusing to readers (and occasionally editors). Source in particular is defined much more broadly under WP:V and WP:RS. WhatamIdoing (talk) 21:44, 22 July 2008 (UTC)

While I appreciate CC's proposal for a new approach, I'm still waiting for comments on my most recent (July 22) attempt to understand the current reality regarding layout for citations and comments. Any help would be greatly appreciated. Butwhatdoiknow (talk) 16:09, 2 August 2008 (UTC)

Sorry :-) It's really hard to sort through these long discussions. I think I see (above) your July 22 proposal. It says in several places that there is "no consensus", which I'm not sure is accurate. There are several different common practices in use, which is different than no consensus. It's hard to tackle this issue here when WP:CITE has been devastated over the last two months, and the pages need to be re-synced. CITE is the main page for that, so it's hard to sort out how to fix this page, when that page is a wreck. SandyGeorgia (Talk) 16:21, 2 August 2008 (UTC)
OK, now that I've looked it over more closely, I'm afraid that adding all of that wording here will just create future syncing problems with WP:CITE. The problem of duplication of text is an issue across all of the MoS pages, and I encourage that we work towards keeping the text in the "main-ish" place, and only linking to it on other guideline pages. It is a layout issue, but it is also primarily discussed at WP:CITE. Can we find a way to briefly summarize and link here, rather than re-writing this page and always needing to keep CITE and LAYOUT in sync? The summary here would say something along the lines of "many different methods of sorting notes, citations and comments, etc.", and then link to that page. And then we need to tackle that page, which is way out of control. SandyGeorgia (Talk) 16:28, 2 August 2008 (UTC)\
I wholeheartedly agree. I'll begin a discussion on that topic below. Butwhatdoiknow (talk) 00:55, 3 August 2008 (UTC)

Whether to modify Layout to state a preferred approach

Generally, because different editors use these sections in different ways in practice, I'm not sure any tightening or change is necessary; it's only a guideline,and guidelines are usually flexible. If someone can show me a problem, we could work on tightening to avoid such problems. SandyGeorgia (Talk) 18:40, 5 July 2008 (UTC)

Hmmm. Are the guidelines intended to reflect the range of practices (whether they are preferred or not) or are they designed to reflect "best practices"? If the the former then I agree that the exercise above is for my benefit alone and we don't need to take the next step of working together to make Layout clearer. On the other hand, as the Manual of Style says "One way of presenting information is often just as good as another, but consistency promotes professionalism, simplicity and greater cohesion in Wikipedia articles." So maybe giving a clear guide to the best practices would be a good idea. What do others think? Butwhatdoiknow (talk) 19:28, 5 July 2008 (UTC)
Because the "right" answer for these sections depends so much on the style of citations, I've tried a different approach at User:WhatamIdoing/Sandbox. It splits the sections according to citation style and is intended to replace the existing Notes and References subsections. I would welcome your reactions (on this page, please, so we can keep the conversation here). WhatamIdoing (talk) 19:34, 5 July 2008 (UTC)
What he said; how the sections are used depends on the citation method. I don't think we need to complicate the page; I've never encountered a problem. SandyGeorgia (Talk) 19:37, 5 July 2008 (UTC)
WhatamIdoing - My reaction is that I support the idea of modifying the current text to make it clearer regarding what should go where (and how). Unfortunately, I am still educating myself regarding what should go where (and how) and, accordingly, I can not speak authoritatively regarding the content of your proposal. Once I complete the process of nailing down the "best practices" regarding layout (a process underway above) I will be happy to return to your proposal and give my newly educated opinion. Butwhatdoiknow (talk) 19:47, 7 July 2008 (UTC)
I think that most of the problems actually appear here, on this page, with editors eager to impose their pet versions on everyone else, despite a complete absence of consensus. To the extent that codifying the actual consensus could cut short those conversations, and perhaps even be useful on occasion to curious editors, I'm in favor of recommending a preferred approach. WhatamIdoing (talk) 03:22, 11 July 2008 (UTC)
Sandy says "show me a problem." The Question section below shows the problem: There is confusion out there regarding whether there are and, if so, what are the preferred formats for comments and citations. The Layout article should be revised to clear up this confusion. (Even if the consensus turns out to be to tell editors that "there are no preferred formats, do whatever the heck you like.") Butwhatdoiknow (talk) 16:18, 19 July 2008 (UTC)
I agree with Butwhatdoiknow, and rather than saying that there is a complete absence of consensus we could say that there are more than one consensus. The current WP:LAYOUT does not reflect this. I have drafted an edit to the policy page, link, however it includes some liberal changes, including moving the Links, Images, and Horizontal dividing line into the Body sections (this is the WP:LAYOUT not WP:MOS). ChyranandChloe (talk) 03:28, 25 July 2008 (UTC)

Defer this issue to WP:Cite?

Above, SandyGeorgia says: Can we find a way to briefly summarize and link here, rather than re-writing this page and always needing to keep CITE and LAYOUT in sync? The summary here would say something along the lines of "many different methods of sorting notes, citations and comments, etc.", and then link to that page. I think this is an excellent idea.
While I believe that this information should be in this article rather than in WP:Cite, the important thing is that it should be in one place or the other (not both). And, as near as I can tell, there is a better chance to get those of us currently working on the Layout article to agree to defer to the Cite article than the other way around. (Then we can all go over to the Cite article and try to fix any problems there.)
We can worry about the exact language later but, for now, what does everyone think of the idea of saying something brief in Layout about References/Notes/etc. and providing a link to more complete information in the Cite article? Butwhatdoiknow (talk) 01:14, 3 August 2008 (UTC)

You mean swapping in something like this?

===Notes, Footnotes, and References===

See also: Wikipedia:Footnotes, Wikipedia:Citing sources, and Wikipedia:ISBN
This section, or group of sections, presents the explanatory notes and a list of the references that support the information in this article. These items belong in appropriately titled sections at this point in the appendices. The notes and references appear after the See also section (if any) and before the Further reading section (if any) and the External links section (if any). The format of these sections and the specific information in each depends entirely on the citation style chosen by the article's editors. Details can be found on the appropriate pages linked above. For the purposes of this guideline, please observe the following guidelines:
  • The headings are always level 2 headings (==References==).
  • Items in a list should be preceded either with a bullet (if alphabetized) or with a number, letter, or symbol (if it refers to an item in the text that is marked by a number, letter or symbol).
  • For the reader's convenience, text which the reader may need to understand the article, such as an explanatory note, is generally listed separately from and before long lists of references.
  • Please avoid naming these sections "Bibliography", "Publications", or "Sources" as these terms have proven confusing on occasion.
Something like that would work for me. WhatamIdoing (talk) 21:45, 3 August 2008 (UTC)
Without getting into specific wording, the first part of your draft (up to "...on the appropriate pages linked above.") is what I (and, I think, Sandy) have in mind. After that your proposal seems to veer into giving instructions, something my proposal would leave for the other articles to do. Butwhatdoiknow (talk) 00:53, 4 August 2008 (UTC)
I think we should do this, then. Not having to keep two pages synchronized is always a benefit. WhatamIdoing (talk) 18:05, 5 August 2008 (UTC)
At a quick glance, it looks good. I reserve the right to pay closer attention later on :-))) SandyGeorgia (Talk) 18:10, 5 August 2008 (UTC)
But should we add single-spaced bullet? I sometimes see editors adding spaces between the bullets, which really lengthens the page. I'm not sure where we deal with that issue as a guideline. SandyGeorgia (Talk) 18:12, 5 August 2008 (UTC)
Does single-spaced bullet refer to "* Item" (compare "*Item" with no space), or do you mean "Please don't put blank lines between items in a list"? WhatamIdoing (talk) 19:59, 5 August 2008 (UTC)
oops, problem with this text: "Items in a list should be preceded with either a bullet (if alphabetized) or a number (if it refers to a numbered item in the text)." This section refers to Notes, and it is common to use a, b, c ... A, B, C, or Greek letters in Notes. They don't have to be numbers. Re WhatamIdoing, not to put blank lines between items, since bullets automatically space. SandyGeorgia (Talk) 15:30, 6 August 2008 (UTC)
Shouldn't the spacing issue go in Wikipedia:MOS#Bulleted and numbered lists instead? (Perhaps we should add a link to that section here.) I have updated the text to include letters and symbols as well as numbers. WhatamIdoing (talk) 17:39, 6 August 2008 (UTC)
Bingo (that would be the place for it, care to start that discussion ove there :-)). Fix looks good. SandyGeorgia (Talk) 17:43, 6 August 2008 (UTC)
All right: discussion started, and I've temporarily put the main MoS page back on my watchlist. WhatamIdoing (talk) 17:50, 6 August 2008 (UTC)

I like where this is going, if I am interpreting this correctly then we are pursuing and nearing a consensus on the following elements:

  • Minimalist approach (exporting the responsibilities to WP:CITE and so on)
  • There should be a single section likely titled === Notes and Citations === or === Notes, Footnotes, and References ===
  • Within the that section we should briefly introduce that WP:CITE determines how information is cited, WP:LAYOUT only defines its arrangements

I understand that a single consensus on which method to utilized would be unlikely in the current climate of this discussion. However, if we can keep track of the variation in referencing, it may hold the potential that there may more standardization in the future:

  • Notes
  • References
  • Note and References (when the number of citations is small enough to fit)
  • Section oriented method (Footnotes and References are two separate sections)
  • Outline oriented method (References is cast over the two subsections: Notes and Bibliography)
  • Separate notes method (see Jane Austen; like similar to section oriented, but explanatory notes are separated from the inline references and lengthy works: Notes References Bibliography)
  • Outline oriented method with separate notes (similar to Outline oriented, but explanatory notes are in a separate section; resulting in Notes, References, Inline Citation, and Bibliography)

The following are interchangeable terms:

  • Inline citation, Notes, Footnotes — they are created with the <ref>...</ref> and {{reflist}} or <references /> tags
  • Non-inline citation, Bibliography, References (if not already used) — generally for long works where it is cited in more than one place, or for citations that has not been placed in inline; should be in a bullet list with some sort of arrangement (alpha by author or title, by order in inline, so on)

So what do you guys think, can begin drafting? Or do we have more elements to vet, discuss, or elaborate on. ChyranandChloe (talk) 02:17, 8 August 2008 (UTC)

As I already indicated previously, the term "references" is a very ambiguous one and is defined as: 1. A note in a publication referring the reader to another passage or source. 2.a. The passage or source so referred to. 2.b. A work frequently used as a source. 2.c. A mark or footnote used to direct a reader elsewhere for additional information. In Wikipedia, the term references more often refers to the end/footnote but that is already given as "Notes."
The term bibliography, however, is very specific: 1. A list of the works of a specific author or publisher. 2.a. A list of writings relating to a given subject: a bibliography of Latin American history. 2.b. A list of writings used or considered by an author in preparing a particular work. 3.a. The description and identification of the editions, dates of issue, authorship, and typography of books or other written material. 3.b. A compilation of such information.
I am following the logical progression of the meaning of the words to propose:
  • References (L2 heading signifying a listing following of all sources of information)
  • Notes (L3 heading signifying a listing of the source of information noted by footnoting/endnoting numeral and source, given either in shorthand or full bibliographical citation form)
  • Bibliography (L3 heading, giving full notations on all secondary/tertiary sources of information in textual/electronic form)
  • External links (L3 heading, signifying electronic links that were used as additional reference sources) FWiW Bzuk (talk) 03:27, 8 August 2008 (UTC).

Draft revision to the Notes and References sections

Well, actually, we've already started drafting. WhatamIdoing suggests:

===Notes, Footnotes, and References===

See also: Wikipedia:Footnotes, Wikipedia:Citing sources, and Wikipedia:ISBN
This section, or group of sections, presents the explanatory notes and a list of the references that support the information in this article. These items belong in appropriately titled sections at this point in the appendices. The notes and references appear after the See also section (if any) and before the Further reading section (if any) and the External links section (if any). The format of these sections and the specific information in each depends entirely on the citation style chosen by the article's editors. Details can be found on the appropriate pages linked above. For the purposes of this guideline, please observe the following guidelines:
  • The headings are always level 2 headings (==References==).
  • Items in a list should be preceded either with a bullet (if alphabetized) or with a number, letter, or symbol (if it refers to an item in the text that is marked by a number, letter or symbol).
  • For the reader's convenience, text which the reader may need to understand the article, such as an explanatory note, is generally listed separately from and before long lists of references.
  • Please avoid naming these sections "Bibliography", "Publications", or "Sources" as these terms have proven confusing on occasion.

I've said that I like What's version (subject to tweaking) up to "... appropriate pages linked above." Sandy appears to have signed off on the full version (subject to tweaking). I suggest we continue to work from What's draft. Butwhatdoiknow (talk) 04:05, 8 August 2008 (UTC)

Can't disagree more strongly on the notion that "references" is a clearly understood term while "bibliography" is misleading. FWiW Bzuk (talk) 14:44, 8 August 2008 (UTC).
That said, are you o.k. with the rest of What's draft? Butwhatdoiknow (talk) 16:27, 8 August 2008 (UTC)
What is the real rationale for further reading, does it actually refer to sources used in formulating the article? If so, then they should appear as part of a bibliography. Further reading implies that these are in addition to the sources already presented, which is very misleading. I am sure that the original drafters of the wording meant to consider that sources were for the reader to check out because they were important to understanding the article, then that makes them secondary or tertiary sources to be included in a bibliography. The entire concept behind "references" is so nebulous, that a lot of redefinition is required. We already have MoS warriors out there reverting like mad because of their interpretations of the terminology. FWiW Bzuk (talk) 16:33, 8 August 2008 (UTC).
Your concerns regarding the references/bibliography issue and your question about further reading are duly noted. Is the rest of What's text o.k.? Butwhatdoiknow (talk) 17:04, 8 August 2008 (UTC)
Now that you ask, I find this statement to be confusing, "For the reader's convenience, text which the reader may need to understand the article, such as an explanatory note, is generally listed separately from and before long lists of references." Does that refer to a "Notes" section, which now makes it unclear as to lists of "Citations" as opposed to footnote/endnotes. In publishing, the footnote/endnote often takes on this dual role, which seems to be fairly confused as either "notes" or "notes and references". BTW, the entire passage is written with an extraneous comma (the so-called Harvard comma) in stating lists, e.g. "Notes, Footnotes, and References" which I would have stated as "Reference sources including notes (foot/endnotes), bibliographies and external links." FWiW, my background is as an academic librarian for over 30 years, and now presently an author and editor at various publishing houses, so forgive my pedantic ramblings as to bibliographic notations. Bzuk (talk) 17:13, 8 August 2008 (UTC).
Every time I ask you come up with at least one more objection. So, unless you tell me I'm wrong, I'll just consider you to be a "no" vote with regard to What's draft. Butwhatdoiknow (talk) 17:48, 8 August 2008 (UTC)
Sorry to sound so contrary, in reiterating some concerns essentially "my revision" would change the direction of the draft as is. FWiW, I have to be a "nope" on this present draft. Bzuk (talk) 18:12, 8 August 2008 (UTC).

Didn't catch that as a draft. Nevertheless, I'll start with the minor and move up. Try to avoid padding: "For the purposes of this guideline, please observe the following guidelines:", it can be reduced to: "Please observe the following guidelines:". We can simplify the title from Notes, Footnotes, and References to Notes and Citation — thus we've circumvented a comma issue in addition to reducing padding. Other than that, I support the prose and title. ¶Giving a set of general guidelines doesn't effectively express the known permutations of the Notes and Citation section. I suggest that we give a list of methods rather than a set of guidelines:

  • Notes, when only explanatory notes exist. Create a Notes section. example: Wikipedia:Layout
  • References, when only inline citation exist. Create a single References section. example: United States Department of Agriculture
  • Notes and references, when both inline citations and explanatory notes exist. Create a Notes and references section. example: Centers for Disease Control and Prevention
  • Outline Oriented, when a reference, usually lengthy, is cited in more than one location from within the work; or when references are not place in an inline manner. Create a single section titled References with two subsections within it titled Notes and Bibliography. Place the inline citations in the Notes and non-inline citations in the References. example: Cockroach
  • Section Oriented, for similar reason to the Outline Oriented method above. Create a two sections: Notes, and References. Place inline citations in Notes and non-inline citations in References. example: Eye movement in music reading
  • Outline Oriented with Separate Notes and Inline Citation, when explanatory notes and inline citations have grown to a point where it is desired to separate the two. Create two sections: Notes and References. Encapsulate two subsections Inline citation and Bibliography within the References section. Place explanatory notes in the Notes section, inline citations in the Inline citation subsection, and non-inline references in the Bibliography subsection. example: Reston ebolavirus
  • Section Oriented with Separate Notes and Inline Citation, for similar reason as above. Create three sections: Notes, References, and Bibliography. Place explanatory notes in the Notes section, inline citation in the References, and non-inline citation in the Bibliography section. example: Jane Austen

I agree with Bzuk, Bibliography should not be confused with Further reading: Bibliography is used to define a list of publications which can be used to verify an article; Further reading is used to define a list of articles or publications which can be used to expand upon the reader's knowledge — used similarly to External links. ¶I don't recommend starting a habit of using L2, L3, and so on. To give you some background: the internet was first developed (in addition to governmental purposes) to help peer-review documents; however, at the time, webpages used to be simply large bodies of text. HTML (actually SGML, its predecessor) was introduced to help divide these large blocks of text into something more readable. Headings was part of the first wave of tags which helped specify what certain pieces of text were. Thus, we have h1 for first level heading (article title), h2 for second level heading, h3 and so on. ¶Perhaps, we should introduce this in Lead section of WP:LAYOUT, or find another method of referring to section headings. ChyranandChloe (talk) 06:11, 9 August 2008 (UTC)

Do I understand that you agree with me that the opening text is o.k. (subject to tweaking) but that you have problems with the "following guidelines"? (We can fight over the new title for the subsection if and when we get some consensus on the text change.) Butwhatdoiknow (talk) 15:54, 9 August 2008 (UTC)
Yes, the text is essentially ok, it only needs a bit of cleanup; and as you said we can fight over the new title and so forth after we get a consensus on the text change. ChyranandChloe (talk) 03:45, 10 August 2008 (UTC)
I oppose inclusion of C&C's list of methods. The major point here is to avoid inclusion of this complication. The list of methods belongs at WP:CITE, not WP:LAYOUT. WhatamIdoing (talk) 20:16, 10 August 2008 (UTC)
WP:CITE states how references are made, different methods of creating references (e.g. <ref>, <cite>, <harv>), and when to use them. WP:LAYOUT states where the sections belong and their arrangement — specifically the different methods of arranging sections. Furthermore, WP:CITE only briefly states that references should be placed near the end of document in a section named Notes or References (or otherwise): no where in its text does it explain how the sections are arranged. I've rewritten the list of methods above to better reflect this. ChyranandChloe (talk) 04:15, 11 August 2008 (UTC)
I'd like to point out that there is a serious problem with using Bibliography instead of References. That is the Bibliography is the preferred heading for a list of the subject's works in a biographical article. In such an article, there would then be two sections titled Bibliography. Let's stick to using References as there is no compelling reason to change it. Wednesday Next (talk) 17:19, 11 August 2008 (UTC)
We have that worked out, see #About Further reading. Further reading contains all material that is not used to verify the article, but provides good background (note that if it is a website, it goes in the external links) — this can include works written but the subject of the article. In many cases I've also seen a section titled Works devoted to the authors works such as K. A. Applegate. One way of putting is that Bibliography is reserved to help verify the article, where Further reading is reserved for background information. ChyranandChloe (talk) 19:07, 11 August 2008 (UTC)
No, we DON'T have that all worked out.
C&C, your personal preference is not the convention used on Wikipedia. We are not going to endorse the use of "Bibliography" instead of "References" just because you personally prefer it. Wednesday Next is right: the convention at Wikipedia is to use Bibliography for books written by the subject of the article. ("Works" is more common for non-book creations, such as visual arts; "Publications" is sometimes used for scientific journal articles.) WhatamIdoing (talk) 19:31, 11 August 2008 (UTC)
You're right, I thought we were near the end of our discussion about Further reading's place — that's why you've implemented it so quickly without draft approval. Nevertheless, both methods are established: Bibliography can be used to hold a list of the subject of the article's works, or it can be used to hold non-inline citation (we may need to work this out, it doesn't seem very consistent). ChyranandChloe (talk) 19:56, 11 August 2008 (UTC)
Again, more discussion is needed in which definitions must be taken in consideration of the terms in use. This means that the whole concept of referencing should include an evolving rather approach. The term bibliography is normally reserved for the list of reference sources used in formulating a work, but has somehow dual meanings/purposes now in use in Wikipedia. FWiW Bzuk (talk) 21:06, 11 August 2008 (UTC).
I beg to differ. The primary use of the word bibliography refers to "A list of the works of a specific author or publisher" (see [1]). The use you refer to for the term is a secondary one (2b, to be precise). Wikipedia has been encouraging the use of this term for its primary purpose for some time, to avoid ambiguity in headings. There is no real reason to reverse direction here. Wednesday Next (talk) 23:20, 11 August 2008 (UTC)
This discussion over the usage of Bibliography should be deferred to #Bibliography vs. References. Wednesday Next, the source you provided is derived from "The American Heritage Dictionary", which specializes in the contemporary usage of the word "Bibliography". It's a change, and we need to explore it in depth — so let's resolve this before we continue with passing the Referencing sections. ChyranandChloe (talk) 04:23, 12 August 2008 (UTC)

Big Change About To Be Made

Based on the discussion above I'm about to remove the current Notes and References sections and replace them with this text:

=== Notes, Footnotes, and References{{anchors|Notes|References}} ===

See also: Wikipedia:Footnotes, Wikipedia:Citing sources, and Wikipedia:ISBN
This section, or group of sections, presents the explanatory notes and a list of the references that support the information in this article. These items belong in appropriately titled sections at this point in the appendices. The notes and references appear after the See also section (if any) and before the Further reading section (if any) and the External links section (if any). The format of these sections and the specific information in each depends entirely on the citation style chosen by the article's editors. Details can be found on the appropriate pages linked above.

I understand that this draft is not perfect. (How could it be? I didn't write it.) And there will be those who will be anxious to "fiddle" with it once it is in the article. (Me, for example.) So please don't object to this change based on wording or phrasing. That said, any reason why I shouldn't plow forward with the change? Butwhatdoiknow (talk) 18:49, 15 August 2008 (UTC)

Overall, I'm satisfied with this as a step in the right direction. I do think that we should include a reasonable level of layout-specific information, like the fact that these lists should be bulleted (numbered, symbol-ed, etc.) instead of plain lists, and that the headers should be level 2 headers instead of level 3, but that can be added later.
I suggest waiting at least 24 hours after your announcement, however, so that people who don't check Wikipedia multiple times in one day have a chance to comment. WhatamIdoing (talk) 22:42, 15 August 2008 (UTC)
Will do. Butwhatdoiknow (talk) 01:09, 16 August 2008 (UTC)
Looks good. Agree with WhatamIdoing on bullets, level 2, et al. SandyGeorgia (Talk) 03:11, 16 August 2008 (UTC)
Curious, though, why the link to the ISBN page? That has nothing to do with layout. Does it? SandyGeorgia (Talk) 03:12, 16 August 2008 (UTC)
It's an improvement to the current one, which is badly out of date. However I would prefer if you placed a list tacking the different methods in which these sections are organized, thus giving strong examples in addition to general guidelines. I won't revert it, which would make this proposal fall short of consensus, but it still needs work. ChyranandChloe (talk) 03:08, 16 August 2008 (UTC)
Yeah, I wondered about ISBN as well. And I also agree that we need to provide more guidance in the guide (although my approach would differ from those of WhatamI and CC). However, if we wait until we have text that everyone will agree to then we'll wait forever. Better, I suggest, to make this change "as is" and then refine it over time. Butwhatdoiknow (talk) 13:13, 16 August 2008 (UTC)

I've implemented it with a change in title from Notes, Footnotes, and References to Notes and citations (Notes and Footnotes seem too closely linked, we're describing sections which hold explanatory notes and citation: both inline and non-inline). I believe the current sections are unacceptably out of date, and although our draft is imperfect: it's better. However, if this is too early, feel free to revert it. For SandyGeorge and Butwhatdoiknow, the ISBN seems unusual to me as well. ChyranandChloe (talk) 01:00, 18 August 2008 (UTC)

ISBN or International Standard Book Number and ISSN, International Standard Serial (Journal, magazine) Number is essentially a "locator" for book merchants, publishers and the public. As a librarian, I constantly referred to ISBN as a means of ordering material, it gave the location by country, publisher and subject as well as giving a particular item code number(s). Where it has application in Wikipedia, is as an aid to those readers who wished to locate the print material. FWiW, the ISBN was considered optional as a "tracing" in cataloguing until recently wherein the usual bibliographic record tends to be more comprehensive and includes the ISBN as a matter of course. Bzuk (talk) 01:05, 18 August 2008 (UTC).
That is all very well and good. The question is whether the Layout article (which is about "where") should point to the ISBN article (which is about a very specific "how"). No doubt the Cite article, and perhaps the Footnotes article, should talk about the use of the ISBN. But, I suggest, we should not clutter up the Layout article with even a mention of it. Butwhatdoiknow (talk) 01:35, 18 August 2008 (UTC)
I support removal of the ISBN link from the (ir)relevant section. WhatamIdoing (talk) 05:00, 19 August 2008 (UTC)

The "general" reference

Does anyone know the current state of wiki-feeling for the "general reference"? That is, it's the reference that isn't used inline and nobody knows what it actually says or supports, but it's listed at the end (See elephant) and we sort of assume that whatever is in the article and should be supported by a source -- well, it must be in the general reference? Is this considered a violation of "consistent formatting" for references? Do FA-class articles include general references? WhatamIdoing (talk) 06:47, 13 July 2008 (UTC)

I don't understand why this would be considered a violation of consistent formatting. In the past FAs used general references frequently. Not sure about the current crop, but it's worth noting that the guidelines should also accomodate articles that don't have the citation density prevailing in most FAs. Many early-stage articles provide only general references. Christopher Parham (talk) 19:23, 13 July 2008 (UTC)
FLs use general references quite often. Take a look at some of the recently promoted ones for an idea of how they are used. Gary King (talk) 19:27, 13 July 2008 (UTC)
Here is a list of a few of the featured articles that have both inline citations and general references (copied from Wikipedia:Verification methods):
Eagle Scout · €2 commemorative coins · Acorn Computers · Absinthe · 1928 Okeechobee Hurricane · Aramaic language · 1896 Summer Olympics · Mumia Abu-Jamal · Michel Foucault · Anarcho-capitalism · Algerian civil war
This makes sense to me for some subjects. I (as a reader) would assume that the inline references each verify specific things in the text, while the general references serve to verify the entire article (i.e., they verify dozens of the things throughout the article, and (possibly) also help verify the article's completeness, structure and emphasis.) ---- CharlesGillingham (talk) 02:30, 14 July 2008 (UTC)

To clarify part of my question: Is it a violation of "consistent formatting" of references to have one reference inline, using <ref>Everyman, J. 2008. ''My Favorite Things.'' Volume 1.</ref>, and another reference not inline in the same article, simply listed as a general reference: * Everyman, J. 2008. My Favorite Things. Volume 2. That is, should all references use the same format -- either being inline or general -- but not both styles mixed together in the same article? WhatamIdoing (talk) 17:48, 14 July 2008 (UTC)

I don't see why this would be a violation of consistency since these references are being used to do different things. Consistency doesn't demand that everything be identical, just that similar things be treated similarly. Christopher Parham (talk) 22:19, 14 July 2008 (UTC)
The better response to this question is should we have general references in Featured Articles? My answer would be no. Facts need to be demonstrated with inline citations in FAs. These general references should be moved to "Further reading" sections. The more interesting question is whether we can do parenthetical and footnote referencing in the same article. I think it is appropriate; the Chicago Manual of Style agrees with me. Under the current orthodoxy, however, this appears to be heavily discouraged, perhaps even verboten. II | (t - c) 02:54, 23 July 2008 (UTC)
I find the "general reference" to be pretty much useless. It seems like "Here, read this whole stack of books, and surely one of them supports whatever it was that you thought was a little off, somewhere. Except maybe the parts that were subtle vandalism, but you can't really tell until you read all of these books."
As for using (Everyman, 2008) in one paragraph and [1] in the next -- yes, that's exactly what the current guidelines prohibit. If you're using author-date-page references, then the only <ref> tags in your article should be for explanatory text. WhatamIdoing (talk) 18:19, 23 July 2008 (UTC)
I agree that articles need to be verified through inline citations, and whenever a work or source is cited in more than one location from within the work: the method of using Short footnotes should be used and a General references section containing the full citation should be created. The idea of a reference that applies throughout the article is possible, but this makes verifying difficult, and in a way the purpose of the "Reference" section is verify the article: not show where it came from. The sections Further reading, Bibliography seems the most appropriate, even though it doesn't specifically cover your situation, Phenylalanine. ChyranandChloe (talk) 03:28, 25 July 2008 (UTC)

Reopening?

Although WhatamIdoing is characterizing a bibliography as a random list of sources, I am confident that authors who list sources do not do them for frivolous reasons. The "for further reading" list appears to be sending out that message: "here is a list of works that may be of use, since they are not cited, but I thought you might want to read them anyway?" FWiW Bzuk (talk) 21:06, 11 August 2008 (UTC).
You'd be surprised. People spam books into reference lists all them time. Some publishers even have PR people doing it. Typically if somebody adds a book under "References" without adding text to the article, it is moved to "Further reading" if appropriate to the article or completely removed if not. Wednesday Next (talk) 23:28, 11 August 2008 (UTC)
I don't recall having characterized anything as a "random list of sources". Bzuk, did you mean to start this conversation here? This discussion is about whether or not a book listed as a reference, without any indication about which facts refer to it, makes sense in a fully developed article. Elephant was used as the example here. There's a sentence in it that says, "An elephant can sink deep into mud, but can pull its legs out readily because its feet become smaller when they are lifted.citation needed" Until recently, there were three "general references" that might, or might not, support any and all facts in the article -- but of course no one would know, because the sources weren't matched with any facts in particular. Do you have an opinion on this issue? WhatamIdoing (talk) 00:11, 12 August 2008 (UTC)
I think we should defer the issue over which words most naturally defines References, Further reading, Bibliography, and so forth in #Bibliography vs. References. ChyranandChloe (talk) 04:20, 12 August 2008 (UTC)

Page format

I have reverted most of the changes made by user:ChyranandChloe (04:08, 5 August 2008):

The first reason is minor. It is generally considered unnecessary to alter hidden text like double spaces after a full stop, or spaces before and after the == text in headers == as it throws up unnecessary edit diffs with no difference to the reader.

The second is not so minor and revolves around a difference in interpretation of the section references. Depending on the number of citations and the style, a reference section may or may not have a {{reflist}} template in it, or it may be a list of alphabetically sorted references (with an optional notes section depending on whether there are any ref tag pairs used for footnoting in the article, or there may be no citations or there may be Harvard referencing). --Philip Baird Shearer (talk) 16:49, 5 August 2008 (UTC)

Please do not revert edits made for coding reliability reasons, which are automated by WikiEd and have no effect on the the page. The second edit was made to improve the visibility of the coding and results example in which <code> tags were replaced with ASCII characters and formatted blockquote tags. Example:

Before formatting:

==See also==
*[[Wikipedia:How to edit a page]]
*[[Wikipedia:Manual of Style]]

After formatting:

== See also ==
* [[Wikipedia:How to edit a page]]
* [[Wikipedia:Manual of Style]]

See also


Of which one regarded the Notes (References) section: it does not effectively change the meaning of previously placed content and cannot be counted as a controversial edit. However, if that section dissatisfies you, please revert that section, rather than the entire page. I have conducted the second revert. ChyranandChloe (talk) 02:08, 6 August 2008 (UTC)

In the future, Chyran, please don't make these non-substantive changes like adding spaces in headers, especially not at the same time as you are making substantive changes to the page. It sounds like you are using some sort of tool that automatically makes these changes. Please disable that feature, if this is the case. Christopher Parham (talk) 04:16, 6 August 2008 (UTC)

ChyranandChloe please see the box at the top of the guideline "When editing this page, please ensure that your revision reflects consensus", you do not yet have a consensus for the changes you made. I suggest that you make them one at a time as putting them all in in one edit makes it difficult to see what it is that you are doing. --Philip Baird Shearer (talk) 21:51, 6 August 2008 (UTC)
Very well, I do not believe improvements such as increasing the visibility of code and its result requires consensus. Nevertheless please state or restate what you were discontent with. ChyranandChloe (talk) 22:09, 6 August 2008 (UTC)
There is no consensus support for the view that adding such spaces to headers improves anything. Evidently you are using an editing tool that can make such changes automatically; perhaps this has misled you to believe that such changes are generally considered productive. This is not the case. Continually making such changes after being reverted and asked to stop is disruptive; edit warring over such trivial issues, as you continue to do on this page, is not acceptable. Christopher Parham (talk) 21:24, 9 August 2008 (UTC)
I understand your grievances, however the edit does not stand alone: I have changed the coding examples to blockquotes to increase visibility (see above). The code cleanup was packaged with that, and the consensus under WP:MOS#Section headings is "paces between the == and the heading text are optional (==H2== versus == H2 ==). These extra spaces will not affect the appearance of the heading, except in the edit window." which makes it uncontroversial. ¶It is possible to consider that reverts are distruptive since it oftentimes reverts both the packaged cleanup, the code visibility edits, and links and spelling cleanups. Whether the code visibility is against consensus or otherwise has not been stated and therefore these edits should not be reverted. ChyranandChloe (talk) 03:56, 10 August 2008 (UTC)
Since you insist on adding pointless whitespace to increase the complexity of your diffs, I have no patience for seeing if there are any valuable changes among the sea of useless ones you are making. I therefore reverted you. If you have actual contributions to make, please make them separately from your null edits. Christopher Parham (talk) 04:17, 10 August 2008 (UTC)
The white space is part of the coding cleanup, and your expression that "I have no patience for seeing if there are any valuable changes among the sea of useless ones you are making." only shows indolence. I understand WP:3RR, however if you do not provide reasonable responses, we may require mediation. ChyranandChloe (talk) 04:21, 10 August 2008 (UTC)
I don't understand what you mean by "the whitespace is part of the coding cleanup." It is not cleaning up anything. If you care deeply about the issue of having spaces in the headers, you are welcome to request mediation. But it would seem easier for you to simply make your edit without inserting those spaces. This would allow people to actually assess the substantive changes you are making. Christopher Parham (talk) 04:25, 10 August 2008 (UTC)
Sorry for the inconvenience (see User talk:Christopher Parham#WP:LAYOUT, permalink [2]) for details. ChyranandChloe (talk)

Coding examples

Coding examples should be made clearer using formatted blockquotes along with ASCII character codes. Current:

==See also==
*[[Wikipedia:How to edit a page]]
*[[Wikipedia:Manual of Style]]

Proposed:

== See also ==
* [[Wikipedia:How to edit a page]]
* [[Wikipedia:Manual of Style]]

See also


Clearer examples helps readers understand the code and the result faster and more easily. ChyranandChloe (talk) 05:36, 10 August 2008 (UTC)

Blanks spaces

There are blanks spaces in the sections Lead section, Formatting, Links (commented out), Images, and Horizontal Rule. However there are none in the other sections. The article should be standardized to only one method. It has been implemented in the NULL EDIT. If you oppose, feel free to revert. ChyranandChloe (talk) 19:28, 11 August 2008 (UTC)

See also

Shouldn't see also come at the end of the section content? Logically, a person would want to see something more after reading the text. =Nichalp «Talk»= 11:10, 8 August 2008 (UTC)

Perhaps the Order of appendices subsection should explain the rationale for the order. -- Boracay Bill (talk) 11:20, 8 August 2008 (UTC)
Ok I should clarify, specifically {{see also}}, not the section See also;;. =Nichalp «Talk»= 11:54, 8 August 2008 (UTC)
The {{see also}} should be placed after the section's title, Wikipedia:Layout#"See also" for one section. This brings precedence that the section also has explanatory information or related information not included in the section, and should be noted before the reader reaches the end of the section's text.
Logically, you are correct, "see also" gives the thought of something unrelated and should be noted at the end—and this the reason for the See also section. However, the {{see also}} template is not the See also section; it implies that there is related information which is important enough to be noted early on, and in which the other templates: {{main}}, {{details}}, and {{further}}—cannot be appropriately used in its place. I hope this helps. Perhaps, as a potential proposal, we could make it mandatory to link each section within a policy page to a section describing why. ChyranandChloe (talk) 05:02, 9 August 2008 (UTC)
Perhaps we should write a policy asserting that each and every statement needs a written-out justification, even if we're just documenting basic grammar or how the wiki software works? What exactly would you put in such a section for something like the MoS advice that the proper names of organizations are capitalized, as specified here?
I oppose this suggestion as both being misguided and creating unnecessarily pointless work. On the relatively rare occasions that someone has a question about why a page recommends a particular approach, they can read the talk page archives or just ask. WhatamIdoing (talk) 20:38, 10 August 2008 (UTC)
It's not a suggestion, I stated that it was held potential as a proposal, that perhaps when our policy has become more mature we can create brief subpages summarizing our discussions — it's distant, but that doesn't mean its irrelevant. ChyranandChloe (talk) 02:45, 11 August 2008 (UTC)

Standard appendices and descriptions → Standard appendicies

Standard appendices and descriptions should be renamed to Standard appendix. The current title is unnecessarily lengthy with "and descriptions" automatically implied. With the HTML comment "Please do not change. There are other articles that link to this title." it is likely that it has been desired to do so before. There is no compromise, since an {{anchor}} tag can be added to ensure that other articles linking to it will remain linked. ChyranandChloe (talk) 06:42, 9 August 2008 (UTC)

"With the HTML comment 'Please do not change. There are other articles that link to this title.' it is likely that it has been desired to do so before." I do not understand this sentence, please rephrase.
What the hidden comment means is that if you change this header you should also change the links which will be broken if you change the title. Whether or not there is an anchor is beside the point, as most links will be to the section header, not to an anchor. --Philip Baird Shearer (talk) 08:39, 9 August 2008 (UTC)
Re. "most links will be to the section header, not to an anchor", apparently either you or I have a misunderstanding. Links are to an ID, not to a section header and not to an anchor. The ID can be provided by a section header, by an anchor, or by numerous other alternative mechanisms. As long as the provided ID matches the target ID of the link, the link will succeed—or such is my understanding of the technicalities rendered in mostly nontechnical language. Examples: I've linked to another section of this talk page by its header name here, and I've dropped an anchor at another header name with the ID of "Demo of linking to an anchor, see later talk page section" at another talk page section and linked to it here. If a section header name is changed, dropping an anchor with the old name will allow existing links to continue working. The question of whether or not this is a good practice is beyond the scope of my response here. -- Boracay Bill (talk) 11:42, 9 August 2008 (UTC)
Given that the section describes multiple different types of appendices, the current title seems fine. Making the title singular is odd and it is not clear why you prefer it that way. Christopher Parham (talk) 21:20, 9 August 2008 (UTC)
I was thinking the same thing, Chris, so I'm reproposing it as Standard appendices. I believe you do not understand the purpose of an anchor, Phillip Baird Shearer, as Boaracy Bill stated: the link will succeed. If you look into the code window of that section you will find a comment that looks like this after the heading <!--Please do not change. There are other articles that link to this title.-->, this means that this title has likely been changed before and reverted. The comment is somewhat ignorant of the usage of anchors. ChyranandChloe (talk) 03:07, 10 August 2008 (UTC)

About Further reading

This has come up several times recently, so here's the story: The section ==Further reading== is for books and other information that fulfill both of these criteria:

  • not being used as references to support any information in the article, and
  • not available online.

Essentially, it's an offline equivalent for ==External links==.

The existing text appears to be opaque to normal people, so I propose changing it to this:

This is a bulleted list, usually alphabetized, of any books, articles, or other publications that you recommend to readers as further reading, useful background, or sources of further information. If this section solely contains material authored by the subject of the article, then it may be titled "Bibliography". If an article contains both a list of works by the article's subject and a list of recommended publications by other authors, then the "Bibliography" precedes the "Further reading" list.

This section does not include publications that were used as reliable sources in writing this article; these should be cited as references. Publications that are available online should be listed in the "External links" section instead of in this section.

This section follows the same formatting rules as the "References" section.

If you have comments or questions, please reply now. Unless there are strong objections, I will plan to make this change tomorrow (or any other editor can make this change on Monday if I don't get to it). WhatamIdoing (talk) 21:00, 10 August 2008 (UTC)

Your proposed rules for using "Bibliography" as a section name seem strange. the Bibliography article says, in part, "A bibliography is a list, either indicative or comprehensive, of writings sharing a common factor: this may be a topic, a language, a period, or some other theme. One particular instance of this is the list of sources used or considered in preparing a work, sometimes called a reference list. [...] A bibliography may be arranged by author, topic, or some other scheme." (arranged by author suggesting that bibliographies are not generally limited to works of a single author) -- Boracay Bill (talk) 01:13, 11 August 2008 (UTC)

I like it, though I oppose the two sentences stating that if the list only contains works by the authored by the subject of the article: Further reading should be renamed to Bibliography. Bibliography should be reserved for referencing, Further reading should be reserved for material that provides background, and as you said: like external links.

This is a bulleted list, usually alphabetized, of any books, articles, or other publications that is recommend to readers as further reading, useful background, or sources of further information. It is placed after the Referencing block, and before the External links.

This section does not include publications that were used as reliable sources in writing this article; these should be cited as references. Publications that are available online should be listed in the "External links" section instead of in this section.

The last sentence stating that it should be formatted like the "References" section should be removed for two reasons: the references section can refer to inline citations, and if it did receive a format (other than its a list) it should conform to external links. ChyranandChloe (talk) 03:06, 11 August 2008 (UTC)

Bill: Yes, in the real world, a bibliography is a flexible creature. But if you use that title on Wikipedia for anything other than a list of the author's own work, it is likely to cause confusion and complaints and people changing it to something else (=pointless load on the servers). That sentence represents a Wikipedia convention, not the system that your English lit teacher might support. I'm not saying that the convention is Right™; I'm saying that this is the actual practice.
C&C: ==Further reading== should certainly not be formatted like ==External links==. Formatting for external links looks like this:
* [http://artist.com/ Name], the official website for the artist that is the subject of this article
I'm not even sure how you'd use that format for an offline book. What we want in ==Further reading== is a proper bibliographic citation for the book/paper/other publication. We want it to look like this:
  • Burgess, Thornton W. (1993). The Adventures of Danny Meadow Mouse. New York: Dover Publications. ISBN 0-486-27565-5. 
I took this sentence out of the original text, but we can certainly be explicit if you think it's needed. WhatamIdoing (talk) 07:08, 11 August 2008 (UTC)

I was a bit confused by what you meant that it should be formatted like the "References" section, so in the derivative of the draft I omitted that altogether. I understand what you mean now. So here's an explicit we could add, "This section should be formatted similar to the Bibliography section of an article." Then we'll add a brief example:

== Further reading ==
{{refbegin}}
* {{cite book |author=Burgess, Thornton W. |title=The Adventures of Danny Meadow Mouse |publisher=Dover Publications |location=New York |year=1993 |isbn=0-486-27565-5}}
{{refend}}

Further reading


  • Burgess, Thornton W. (1993). The Adventures of Danny Meadow Mouse. New York: Dover Publications. ISBN 0-486-27565-5. 

So if we compile it, then it would probably look something like this:

===Further reading===
This is a bulleted list, usually alphabetized, of any books, articles, or other publications that is recommend to readers as further reading, useful background, or sources of further information. It is placed after the Referencing block, and before the ''External links''.

This section does not include publications that were used as [[WP:RS|reliable sources]] in writing this article; these should be [[WP:CITE|cited as references]]. It is formatted similarly to the ''Bibliography'' section, in which each entry is cited as if it were to be used as sources to verify an article:
<blockquote style="color: #000000; background: #FFFFFF; padding: 1em; border: 1px solid #8FBC8F"><tt>
== Further reading ==<br />
{{refbegin}}<br />
* {{cite book |author=Burgess, Thornton W. |title=The Adventures of Danny Meadow Mouse |publisher=Dover Publications |location=New York |year=1993 |isbn=0-486-27565-5}}<br />
{{refend}}
</tt></blockquote>
<blockquote style="background: #FFFFFF; padding: 1em; border: 1px solid #999999">
<font size="3">'''Further reading'''</font>
----
{{refbegin}}
* {{cite book |author=Burgess, Thornton W. |title=The Adventures of Danny Meadow Mouse |publisher=Dover Publications |location=New York |year=1993 |isbn=0-486-27565-5}}
{{refend}}
</blockquote>

With Google books, works are beginning to be easily available online. Thus we should omit the sentence "Publications that are available online should be listed in the External links section instead of in this section." External links should be reserved for websites, such as the subject's official website, and so forth. ChyranandChloe (talk) 19:19, 11 August 2008 (UTC)

C&C, it's very hard to read things that you stick in a scrolling box like that. I have to read each line by scrolling out to the end. I have serious joint problems, so reading stuff in those boxes is literally painful. Other editors have complained about this, but you don't seem to get it, so let me be very clear: Stop using those scrolling boxes. It annoys many people and is not accessible to disabled people.
As for your proposed text:
We cannot tell people to format it like the "Bibliography" section because this is the bibliography section (when used to list the author's own works). We need to include the text that clarifies the specific convention for a "Bibliography" section on Wikipedia. It's not just me, BTW: Wednesday next independently posted the same information in another section on this page. I'm sorry if your personal preference doesn't line up with the convention, but we're stuck with the convention.
We also do not want to show the code for the citation template, because use of citation templates is neither encouraged or discouraged. A link to WP:CITE#HOW should be good enough.
Thanks for your views. I will make these changes in a little while. WhatamIdoing (talk) 19:26, 11 August 2008 (UTC)
True: if it's a regular book that is incidentally available online through books.google or Gutenberg Press, then it's still "further reading". I've updated the text to be specific to websites and online publications. WhatamIdoing (talk) 19:44, 11 August 2008 (UTC)
I'm sorry, I didn't know WhatamIdoing — I use the scroll box since it wouldn't push on the screen instead. It would be incorrect to state that this is a personal preference and to also state that what you are stating is not your own personal preference. Both methods were established before we arrived, it's only that we've adopted them. I believe that it is possible that both methods are correct: Bibliography can be used to hold the works by the author and non-inline citation. I pulled the citation template from you post to create the coding example; but, yes, you are right, we shouldn't endorse it here. ChyranandChloe (talk) 19:46, 11 August 2008 (UTC)
You