Recent Changes for "Wiki Style Guide" - Davis Wiki

Wiki Style Guide

NickSchmalenberger — 2009-05-01 03:50:54

i see iso so i ...

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 72:	Line 72:
- It turns out there is an '''international''' standard for dates. It's called ISO-8601 and was developed by the International Standards Organization. Simply put, it is YYYY-MM-DD. It was determined not by political means, but by scientific (rational) means. It has these advantages:	+ It turns out there is an '''international''' standard for dates. It's called ISO-8601 and was developed by the International Organization for Standardization. Simply put, it is YYYY-MM-DD. It was determined not by political means, but by scientific (rational) means. It has these advantages:

Wiki Style Guide

WilliamLewis — 2009-04-30 18:14:55

yeah right

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 7:	Line 7:
- When in doubt, check the [http://www-styleguide.ucdavis.edu/styleguide.pdf Official UCD Style Guide] or the [http://www.apstylebook.com/ AP Stylebook]. Note that style is not absolute; different places can have styles different from the AP and still be perfectly acceptable as long as they're consistent. For instance, the DavisWiki has come to use "AM/PM" instead of "a.m./p.m." Not mentioned in the UCD Styleguide is addresses. Official communications tend to use "194 Young", whereas there are good reasons for using "Young 194" instead. The latter format is preferred.	+ When in doubt, check the [http://www-styleguide.ucdavis.edu/styleguide.pdf Official UCD Style Guide] or the [http://www.apstylebook.com/ AP Stylebook]. Note that style is not absolute; different places can have styles different from the AP and still be perfectly acceptable as long as they're consistent. For instance, the DavisWiki has come to use "AM/PM" instead of "a.m./p.m." Not mentioned in the UCD Styleguide is addresses. Official communications tend to use "194 Young", whereas there are good reasons for using "Young 194" instead. The latter format is preferred. ''Or not. Is ["Chem 194"] a classroom or a course? 194 Chem is unambiguous and preferred by ["Users/WilliamLewis" this editor].''

Wiki Style Guide

JasonAller — 2008-08-19 16:39:05

link fixes

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 18:	Line 18:
- What do you guys think of capitalizing the first word of a page name and leaving the rest lower-case unless it's a proper name? Personally, I think it looks much better. - ["MikeIvanov"]	+ What do you guys think of capitalizing the first word of a page name and leaving the rest lower-case unless it's a proper name? Personally, I think it looks much better. - ["Users/MikeIvanov"]
Line 30:	Line 30:
- ''When we're making pages for public figures who have an initial in their name, do we use a period? ["Peter J. Shields"] has a period, but ["JB Anderson"] does not (there are others as well). What's the consensus opinion here?'' --["ArlenAbraham" aa]	+ ''When we're making pages for public figures who have an initial in their name, do we use a period? ["Peter J. Shields"] has a period, but ["JB Anderson"] does not (there are others as well). What's the consensus opinion here?'' --["Users/ArlenAbraham" aa]
Line 32:	Line 32:
- I created JB Anderson and did not use periods because that is the way it was presented in the list I had. I do know that some people in the 1800s and early 1900s went by their initials professionally (JB, BJ, AJ, etc). I would imagine that, like official entries for various businesses, using what use as their ''official'' title (on letterhead, in the news) is probably best, possibly combined with a redirect for search purposes in cases where it is possible or likely that a visitor might search for the wrong format (although "J.B. Anderson" does return JB Anderson among the returns). -- ["JabberWokky" jw]	+ I created JB Anderson and did not use periods because that is the way it was presented in the list I had. I do know that some people in the 1800s and early 1900s went by their initials professionally (JB, BJ, AJ, etc). I would imagine that, like official entries for various businesses, using what use as their ''official'' title (on letterhead, in the news) is probably best, possibly combined with a redirect for search purposes in cases where it is possible or likely that a visitor might search for the wrong format (although "J.B. Anderson" does return JB Anderson among the returns). -- ["Users/JabberWokky" jw]
Line 52:	Line 52:
- ''What about dates? There are a few pages like ["Thong H. Huynh Awards"] with dates. Some sort ascending, some sort descending. How do we want to standardize this? IMHO, it looks best to have the most recent date at the top.'' --["ArlenAbraham"]	+ ''What about dates? There are a few pages like ["Thong H. Huynh Awards"] with dates. Some sort ascending, some sort descending. How do we want to standardize this? IMHO, it looks best to have the most recent date at the top.'' --["Users/ArlenAbraham"]
Line 81:	Line 81:
- ''I strongly encourage all people to use this new universal standard, and I have done so since 2000-01-01. --["SteveDavison"]''	+ ''I strongly encourage all people to use this new universal standard, and I have done so since 2000-01-01. --["Users/SteveDavison"]''
Line 94:	Line 94:
- Thoughts? I'm not sure I'm phrasing this very concisely or clearly, so I'd appreciate any help.. Maybe it would be best to just say "When editing, keep in mind the years to come and what will need to be updated and how difficult that may be."? --["PhilipNeustrom"]	+ Thoughts? I'm not sure I'm phrasing this very concisely or clearly, so I'd appreciate any help.. Maybe it would be best to just say "When editing, keep in mind the years to come and what will need to be updated and how difficult that may be."? --["Users/PhilipNeustrom"]
Line 96:	Line 96:
- ''(from ["AlphaDog"])'' How about:	+ ''(from ["Users/AlphaDog"])'' How about:
Line 99:	Line 99:
- ''Is this duplication of information thing a reference to the Latin American Restaurants page?'' --["SummerSong"] - ''I don't think it's intended as a personal slight. I've noticed a lot of redundancies getting posted as well, so I think it's just a matter of good record-keeping. Maintaining multiple sources of info inevitably causes big problems down the road. BTW: Was that a mulberry tree in your yard??'' --["AlphaDog"]	+ ''Is this duplication of information thing a reference to the Latin American Restaurants page?'' --["Users/SummerSong"] + ''I don't think it's intended as a personal slight. I've noticed a lot of redundancies getting posted as well, so I think it's just a matter of good record-keeping. Maintaining multiple sources of info inevitably causes big problems down the road. BTW: Was that a mulberry tree in your yard??'' --["Users/AlphaDog"]
Line 109:	Line 109:
- * ''I am debating whether it is worthwhile to use NewsBank links for old newspaper articles. A lot of people won't be able to access them (the login prompt may confuse them too) and the URLs are incredibly long (making it hard to edit the page), but it could useful for those on campus.'' --["AndrewChen"] - * ''I don't think it's a great idea, although it would be wonderful if there was an open resource like it. Open information dependent on closed information is a bad feel, IMO. Plus it excludes all ["townies"] and out of town readers (since the entries with the most citations are likely the ones of most interest to non-Davis residents looking up info about Davis). If it were the only source to cite, it might be okay, but even then, author + title + date + publication can get you the article in '''any''' archive at a library, NewsBank or otherwise.'' --["JabberWokky"]	+ * ''I am debating whether it is worthwhile to use NewsBank links for old newspaper articles. A lot of people won't be able to access them (the login prompt may confuse them too) and the URLs are incredibly long (making it hard to edit the page), but it could useful for those on campus.'' --["Users/AndrewChen"] + * ''I don't think it's a great idea, although it would be wonderful if there was an open resource like it. Open information dependent on closed information is a bad feel, IMO. Plus it excludes all ["townies"] and out of town readers (since the entries with the most citations are likely the ones of most interest to non-Davis residents looking up info about Davis). If it were the only source to cite, it might be okay, but even then, author + title + date + publication can get you the article in '''any''' archive at a library, NewsBank or otherwise.'' --["Users/JabberWokky"]

Wiki Style Guide

BrentLaabs — 2008-08-12 14:48:14

reply to MikeIvanov

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 19:	Line 19:
	+ * No, I think newspaper headline style is better -- capitalize most words except for articles and minor verbs. --["Users/BrentLaabs"]

Wiki Style Guide

JasonAller — 2007-10-12 10:12:11

moving content from Wiki/Dates

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 67:	Line 67:
	+ == Date Conventions == + + In the U.S. people usually write dates as MM-DD-YY. The two-digit years caused the Y2K panic. Incredibly, people seemed to learn nothing from that and still write MM-DD-YY. This is especially confusing with low years, as they can be confused with month or day numbers. For example, when is 01-05-11? Parts of Europe use DD-MM-YY, other places uses YY-MM-DD, it can be ambiguous. Imagine looking back from 2050 and needing to determine when a document dated 01-05-11 was written. + + It turns out there is an '''international''' standard for dates. It's called ISO-8601 and was developed by the International Standards Organization. Simply put, it is YYYY-MM-DD. It was determined not by political means, but by scientific (rational) means. It has these advantages: + + * Putting Most-middle-least significant order means dates can be easily sorted, especially if the dates begin the line. + * Using dashes instead of slashes avoids confusion with 1's in handwritten dates, i.e. 11/1/11. + * Using four digit years removes century ambiguity. + * Having fixed field widths (always -02- never just -2-) facilitates sorting and has other advantages. + + It's easy for Americans to learn the new system since the month and date order don't change. + + ''I strongly encourage all people to use this new universal standard, and I have done so since 2000-01-01. --["SteveDavison"]'' + + This is the format used by Wiki comments, BTW. +

Wiki Style Guide

JasonAller — 2007-09-27 18:53:07

gnoming

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 1:	Line 1:
	+ [[TableOfContents(right)]] +
Line 7:	Line 9:
- [[TableOfContents]]
Line 20:	Line 21:
- If you want to make a page about someone, say the UCD Chancellor, Larry Vanderhoef, you should probably name that page "Larry Vanderhoef" (note the space). The page that start with "Users/" is going to be the page associated with a particular wiki user. A link to this page is in their upper right hand corner all the time and is automatically linked when they make an edit or comment, so this page is tied to the wiki user in a special way.	+ If you want to make a page about someone, say the UCD Chancellor, Larry Vanderhoef, you should probably name that page "Larry Vanderhoef" (note the space). If on the other hand you are Larry Vanderhoef you could create a page for yourself with the name "Users/LarryVanderhoef". The page that start with "Users/" is going to be the page associated with a particular wiki user. A link to this page is in their upper right hand corner all the time and is automatically linked when they make an edit or comment, so this page is tied to the wiki user in a special way.
Line 35:	Line 36:
- It's important to keep the wiki clean, and thus many useless pages are eventually deleted. Redirecting pages are sometimes seen as useless when no other pages within the wiki link to them. Here are some things to consider before deleting a redirecting page:	+ It's important to keep the wiki clean, and thus many useless pages are eventually deleted. Redirecting pages are sometimes seen as useless when ["Orphaned Pages" no other pages within the wiki link to them]. Here are some things to consider before deleting a redirecting page:
Line 57:	Line 58:
- * Want a fact checked? Write ''(please check)'' next to something you want checked. Want a photo taken? Write ''(photo request)'' next to something you want a photo of. Doing this will allow for determined folks to easily search for the phrases ''please check'' and ''photo request'' to find things to do. - * Names of books and movies are ''italicised'' rather than __underlined__. Underlining is reserved for writing things by hand or by typewriter when italics are impossible. Names of smaller, shorter works such as articles or songs within an album are surrounded by "double quotes." Also, punctuation marks ''always'' go inside the quotes unless you are posing a question which contains a quote. Ex: Did he really say "you're a floozy"?	+ * Want a fact checked? Write {{{[[Include(FactCheck)]]}}} next to something you want checked. Want a photo taken? Write {{{[[Include(PhotoRequest)]]}}} next to something you want a photo of. Doing this will allow for determined folks to easily search for the phrases ''please check'' and ["Photo Requests"] to find things to do. + * Names of books and movies are ''italicized'' rather than __underlined__. Underlining is reserved for writing things by hand or by typewriter when italics are impossible. Names of smaller, shorter works such as articles or songs within an album are surrounded by "double quotes." Also, punctuation marks ''always'' go inside the quotes unless you are posing a question which contains a quote. Ex: Did he really say "you're a floozy"?

Wiki Style Guide

JasonAller — 2007-06-24 10:07:08

interwiki link to help

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 86:	Line 86:
- If a reference is applicable to a specific passage, use the footnote ["Wiki Community/All Known Macros" macro] after the end of the sentence or paragraph. e.g.	+ If a reference is applicable to a specific passage, use the footnote [wiki:wikispot:"Help with Macros" macro] after the end of the sentence or paragraph. e.g.

Wiki Style Guide

PhilipNeustrom — 2007-04-23 21:52:59

(quick edit)

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 20:	Line 20:
- If you want to make a page about someone, say the UCD Chancellor, Larry Vanderhoef, you should probably name that page "Larry Vanderhoef" (note the space). The page that start with "Users/" is going to be the page associated with that wiki user. A link to this page is in their upper right hand corner all the time and is automatically linked when they make an edit or comment, so this page is tied to the wiki user in a special way.	+ If you want to make a page about someone, say the UCD Chancellor, Larry Vanderhoef, you should probably name that page "Larry Vanderhoef" (note the space). The page that start with "Users/" is going to be the page associated with a particular wiki user. A link to this page is in their upper right hand corner all the time and is automatically linked when they make an edit or comment, so this page is tied to the wiki user in a special way.

Wiki Style Guide

PhilipNeustrom — 2007-04-23 21:52:06

got rid of the "NameWithoutSpace" thing in here, replaced with more-clear "Users

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 12:	Line 12:
	+
Line 19:	Line 20:
- If you want to make a page about someone, say the UCD Chancellor, Larry Vanderhoef, you should probably name that page "Larry Vanderhoef" (note the space). When there are pages for people where their name ''isn't'' spaced out, such as {{{FirstnameLastname}}}, this is the page ''for'' that user -- for their ''username''. If you know they're going to sign up for the wiki, or if they aren't famous or really important at all, then it doesn't much matter. The with pages that have a ''username'' as their title are going to be the page associated with that user (it's up in their upper right hand corner all the time, it's automatically a link when they make an edit, etc).	+ If you want to make a page about someone, say the UCD Chancellor, Larry Vanderhoef, you should probably name that page "Larry Vanderhoef" (note the space). The page that start with "Users/" is going to be the page associated with that wiki user. A link to this page is in their upper right hand corner all the time and is automatically linked when they make an edit or comment, so this page is tied to the wiki user in a special way.
Line 21:	Line 22:
- Think of it this way: the username page is the page ''for'' that person to use. The page with the name spaced out is the page where historical information about them might go.	+ Think of it this way: the username page (starts with "Users/") is the page ''for'' that person to use. The page without the "Users" in front is the page where historical information about the person might go.
Line 24:	Line 25:
- Pages with peoples' NamesLikeThis are pages for people ''on'' the wiki to ''use''. Pages with Names Like This for people are pages for people from a more biographical standpoint. Generally, people put highly-personal or wiki-centric information on their ''own'' page. If they're a public figure, then ''other people'' are expected to control the content of the biographical page.	+ Pages that start with "Users/" are pages for people ''on'' the wiki to ''use''. Pages without the "Users" in front are just like normal wiki pages, etiquette-wise, which means they are pages from a more biographical standpoint. Generally, people put highly-personal or wiki-centric information on their ''own'' page. If they're a public figure, then ''other people'' are expected to control the content of the biographical page.

Wiki Style Guide

JasonAller — 2007-04-08 19:13:09

link fix

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 13:	Line 13:
- * '''Street names''' should be fully spelled out. Eg ["A Street"] or ["Covell Boulevard"]. If you'd like, you can make a ["redirect template" redirect] for the shortened version, eg ["A St."]	+ * '''Street names''' should be fully spelled out. Eg ["A Street"] or ["Covell Boulevard"]. If you'd like, you can make a [wiki:wikispot:"Help with Linking" redirect] for the shortened version, eg ["A St."]

Wiki Style Guide

JabberWokky — 2006-07-30 22:26:50

Reply (opinion)

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 90:	Line 90:
	+ * ''I don't think it's a great idea, although it would be wonderful if there was an open resource like it. Open information dependent on closed information is a bad feel, IMO. Plus it excludes all ["townies"] and out of town readers (since the entries with the most citations are likely the ones of most interest to non-Davis residents looking up info about Davis). If it were the only source to cite, it might be okay, but even then, author + title + date + publication can get you the article in '''any''' archive at a library, NewsBank or otherwise.'' --["JabberWokky"]

Wiki Style Guide

AndrewChen — 2006-07-30 22:17:36

NewsBank?

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 89:	Line 89:
	+ * ''I am debating whether it is worthwhile to use NewsBank links for old newspaper articles. A lot of people won't be able to access them (the login prompt may confuse them too) and the URLs are incredibly long (making it hard to edit the page), but it could useful for those on campus.'' --["AndrewChen"] +

Wiki Style Guide

JabberWokky — 2006-07-30 21:36:07

+ISO, footnoting primary information by date (Rent "freshness")

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 83:	Line 83:
- While Davis Wiki does not follow the strict [wiki:Wikipedia:Wikipedia:Verifiability Verifiability] and [wiki:Wikipedia:Wikipedia:No_original_research No Original Research] policies of Wikipedia, it is good practice to cite any sources you use, particularly if you are using a direct quote or facts/figures from a publication or website.	+ It is good practice to cite any sources you use, particularly if you are using a direct quote or facts/figures from a publication or website. Note that Davis Wiki does not follow the strict [wiki:Wikipedia:Wikipedia:Verifiability Verifiability] and [wiki:Wikipedia:Wikipedia:No_original_research No Original Research] policies of Wikipedia, especially the latter, since the local nature of the subject allows for much primary research.
Line 86:	Line 86:
- {{{Chief Jim Hyde resigned in June 2006. [[Footnote(Keene, Lauren. ''Hyde resigns as chief.'' ["The Davis Enterprise"]. 14 Jun. 2006.)]]}}}	+ {{{Chief Jim Hyde resigned in June 2006. [[Footnote(Keene, Lauren. ''Hyde resigns as chief.'' ["The Davis Enterprise"]. 2006-07-14.)]]}}}
Line 88:	Line 88:
	+ + Primary research can be either footnoted or information relevant to the source can be added in the edit comment. For instance "I stopped in yesterday and asked". For items that might change in the future, a footnote indicating when or where the information was gathered might be appropriate. + + {{{Rent is $1050 for two bedrooms, $1300 for three. [[Footnote(As of 2006-07-14.)]]}}} + or even better + {{{Rent is $1050 for two bedrooms, $1300 for three. [[Footnote(According to the manager, 2006-07-14.)]]}}} + + Note that another way to reference material is via ["interwiki links"]. Material that is removed from the target can be retrieved by looking up the history of the citation and then the history of the target article. As a result, a simple link can be made.

Wiki Style Guide

JabberWokky — 2006-07-30 21:25:11

+importance of author and title (which my old method didn't do)

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 87:	Line 87:
- If a reference is applicable to large parts of the page, cite it at the end in a "References" or "Sources" section. The format of the citation is not important but should at least contain the title and date of publication for printed material and the URL for online resources.	+ If a reference is applicable to large parts of the page, cite it at the end in a "References" or "Sources" section. The format of the citation is not important but should at least contain the title, author and date of publication for both printed material and online resources. Linking to the URL via the title is preferred, but do not just cite the URL, as it could change. Giving the author, title and publication (even for online articles) gives later editors and readers a chance to find the article via internet or site search engines.

Wiki Style Guide

AndrewChen — 2006-07-30 21:04:42

Citations

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 81:	Line 81:
	+ + = Citing Sources = + While Davis Wiki does not follow the strict [wiki:Wikipedia:Wikipedia:Verifiability Verifiability] and [wiki:Wikipedia:Wikipedia:No_original_research No Original Research] policies of Wikipedia, it is good practice to cite any sources you use, particularly if you are using a direct quote or facts/figures from a publication or website. + + If a reference is applicable to a specific passage, use the footnote ["Wiki Community/All Known Macros" macro] after the end of the sentence or paragraph. e.g. + {{{Chief Jim Hyde resigned in June 2006. [[Footnote(Keene, Lauren. ''Hyde resigns as chief.'' ["The Davis Enterprise"]. 14 Jun. 2006.)]]}}} + If a reference is applicable to large parts of the page, cite it at the end in a "References" or "Sources" section. The format of the citation is not important but should at least contain the title and date of publication for printed material and the URL for online resources.

Wiki Style Guide

JabberWokky — 2006-07-21 16:17:15

Reply to Arlen

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 28:	Line 28:
	+ + I created JB Anderson and did not use periods because that is the way it was presented in the list I had. I do know that some people in the 1800s and early 1900s went by their initials professionally (JB, BJ, AJ, etc). I would imagine that, like official entries for various businesses, using what use as their ''official'' title (on letterhead, in the news) is probably best, possibly combined with a redirect for search purposes in cases where it is possible or likely that a visitor might search for the wrong format (although "J.B. Anderson" does return JB Anderson among the returns). -- ["JabberWokky" jw]

Wiki Style Guide

ArlenAbraham — 2006-07-21 12:10:43

two questions for the community

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 26:	Line 26:
	+ === Initials === + ''When we're making pages for public figures who have an initial in their name, do we use a period? ["Peter J. Shields"] has a period, but ["JB Anderson"] does not (there are others as well). What's the consensus opinion here?'' --["ArlenAbraham" aa] +
Line 44:	Line 47:
	+ ''What about dates? There are a few pages like ["Thong H. Huynh Awards"] with dates. Some sort ascending, some sort descending. How do we want to standardize this? IMHO, it looks best to have the most recent date at the top.'' --["ArlenAbraham"]

Wiki Style Guide

JasonAller — 2006-07-15 19:49:16

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 56:	Line 56:
- * Numbers larger than ten should be represented by figures. Don't start a sentance with a figure.	+ * Numbers larger than ten should be represented by figures. Don't start a sentence with a figure.

Wiki Style Guide

ArlenAbraham — 2006-07-15 19:36:41

added numbers thing

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 56:	Line 56:
	+ * Numbers larger than ten should be represented by figures. Don't start a sentance with a figure. + ''Example: Bob has two bikes. Alice has 11 bikes.'' +

Wiki Style Guide

BrentLaabs — 2006-05-20 12:44:20

hey arlen, you missed one

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 57:	Line 57:
- See also: ["Wiki Ethics"], ["Davis Wiki Guide"] and [http://c2.com/cgi/wiki?GoodStyle Good Style].	+ See also: ["Wiki Ethics"], ["Davis Wiki Guide"] and [wiki:Wiki:GoodStyle Good Style].
Line 67:	Line 67:
- ''(from ["AlphaDog"])'' - How about:	+ ''(from ["AlphaDog"])'' How about:

Wiki Style Guide

PhilipNeustrom — 2006-05-20 12:30:29

removed photo caption suggestion because i disagr

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 55:	Line 55:
	+ * ''I disagree with this. I will try and see if I can find this old photo guideline that was down at the california aggie.''
Line 62:	Line 63:
- Try to avoid segmenting and replicating information across pages. Putting the same information on a bunch of pages makes keeping information updated extremely difficult and also makes searching very hard. Keep the information about a particular topic on the page devoted to that topic, for the most part. General pages that collect information from specific pages are terrific and useful, but keep in mind that you want to minimize replication of things that change frequently otherwise it will become harder, down the road, to keep it all updated.	+ Try to avoid segmenting and replicating information across pages. Putting the same information on a bunch of pages makes keeping information updated extremely difficult and also makes searching very hard. Keep the information about a particular topic on the page devoted to that topic, for the most part. General pages that collect information from specific pages are terrific and useful, but keep in mind that you want to minimize replication of things that change frequently otherwise it will become harder, down the road, to keep it all updated.

Wiki Style Guide

NickSchmalenberger — 2006-04-24 17:29:00

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 54:	Line 54:
	+ * When captioning a photo, be informative instead of interpretive. For example, it is better to say where the picture was taken or who the subject is instead of making a joke. Overall, be mild, explicit, and not flippant.

Wiki Style Guide

SteveDavison — 2006-04-10 09:36:53

styleguide links

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 4:	Line 4:
	+ + When in doubt, check the [http://www-styleguide.ucdavis.edu/styleguide.pdf Official UCD Style Guide] or the [http://www.apstylebook.com/ AP Stylebook]. Note that style is not absolute; different places can have styles different from the AP and still be perfectly acceptable as long as they're consistent. For instance, the DavisWiki has come to use "AM/PM" instead of "a.m./p.m." Not mentioned in the UCD Styleguide is addresses. Official communications tend to use "194 Young", whereas there are good reasons for using "Young 194" instead. The latter format is preferred.
Line 44:	Line 46:
- Often times the conversations or comments inside of a page contribute a lot to the page's worth. If possible, integrate and re-structure the page to reflect the important information contained in comments. If a comment is directed at you and it's hardly valuable to anyone else after you've read it, then removing it un-clutters the page. Leaving the subjective/experience-based poritions of comments attributed to those who make them keeps (more) subjective knowledge around.	+ Often times the conversations or comments inside of a page contribute a lot to the page's worth. If possible, integrate and re-structure the page to reflect the important information contained in comments. If a comment is directed at you and it's hardly valuable to anyone else after you've read it, then removing it un-clutters the page. Leaving the subjective/experience-based portions of comments attributed to those who make them keeps (more) subjective knowledge around.

Wiki Style Guide

ArlenAbraham — 2006-02-21 00:15:51

we should outline naming conventions here, but i have a midterm in <9hrs.

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 10:	Line 10:
-	+ == General naming rules == + * '''Street names''' should be fully spelled out. Eg ["A Street"] or ["Covell Boulevard"]. If you'd like, you can make a ["redirect template" redirect] for the shortened version, eg ["A St."] + * Unless it is part of the actual business name, '''the word "Davis" can be omitted from most page names'''. Because this is the ''Davis'' wiki, pages can be assumed to be Davis-centric. EG rather than "Davis Weather", just call the page ["Weather"]. On the other hand, business pages should always be the name of the business. ["Davis Auto Body"] for example, has the word "Davis" as the title and should be named as such.

Wiki Style Guide

PhilipNeustrom — 2006-02-19 13:30:38

+ redirects

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 22:	Line 22:
	+ == Renaming pages & Redirecting pages == + Sometimes, for whatever reason, it's a good idea to change the title of a page. Using the "Rename" feature will cause the old page to redirect to the new page, and thus all old links do not need to be updated. This old page is said to be a "redirect" to the new page. Redirects can be made manually, by inserting {{{#redirect Page Name}}} into the first line of a page. + + It's important to keep the wiki clean, and thus many useless pages are eventually deleted. Redirecting pages are sometimes seen as useless when no other pages within the wiki link to them. Here are some things to consider before deleting a redirecting page: + 1. Does the redirecting page aid the user in finding the content by providing an alternative title for the material? + 1. Do resources outside the wiki link to the redirecting page? + + (1) is usually easy enough to figure out, but (2) is harder to know because even good search engines cannot index everything.

Wiki Style Guide

PhilipNeustrom — 2006-01-12 00:03:03

doesn't have to do w/style? -- gen. discussion?

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 59:	Line 59:
- - = Wiki != Livejournal = - That is all.

Wiki Style Guide

BrentLaabs — 2006-01-12 00:01:25

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 59:	Line 59:
	+ + = Wiki != Livejournal = + That is all.

Wiki Style Guide

ChrisTakemura — 2005-09-17 13:04:24

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 41:	Line 41:
	+ * Capitalize in a standard English style on all pages which you expect to be useful. (Do as you like on your personal page.)

Wiki Style Guide

PhilipNeustrom — 2005-09-01 11:14:07

typo

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 48:	Line 48:
- Try to avoid segmenting and replicating information across pages. Putting the same information on a bunch of pages makes keeping information updated extremely difficult and also makes searching very hard. Keep the information about a particular topic on the page devoted to that topic, for the most part. General pages that collect information from specific pages are terrific and useful, but keep in mind that you want to minimize replication of things that changeg frequently otherwise it will become harder, down the road, to keep it all updated.	+ Try to avoid segmenting and replicating information across pages. Putting the same information on a bunch of pages makes keeping information updated extremely difficult and also makes searching very hard. Keep the information about a particular topic on the page devoted to that topic, for the most part. General pages that collect information from specific pages are terrific and useful, but keep in mind that you want to minimize replication of things that change frequently otherwise it will become harder, down the road, to keep it all updated.

Wiki Style Guide

AlphaDog — 2005-07-08 07:35:14

+reply

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 1:	Line 1:
- = Something to keep in mind =
Line 6:	Line 5:
	+ [[TableOfContents]]
Line 52:	Line 52:
	+ ''(from ["AlphaDog"])''
Line 56:	Line 57:
	+ *''I don't think it's intended as a personal slight. I've noticed a lot of redundancies getting posted as well, so I think it's just a matter of good record-keeping. Maintaining multiple sources of info inevitably causes big problems down the road. BTW: Was that a mulberry tree in your yard??'' --["AlphaDog"]

Wiki Style Guide

SummerSong — 2005-07-07 13:20:14

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 55:	Line 55:
	+ *''Is this duplication of information thing a reference to the Latin American Restaurants page?'' --["SummerSong"]

Wiki Style Guide

AlphaDog — 2005-07-07 13:03:55

Suggestions... maybe too wordy

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 51:	Line 51:
	+ + How about: + * "Avoid relative time references, e.g. yesterday, to help us keep the wiki current; it would be preferable to include a specific date reference that will still make sense six months from now." + * "Duplicating information on multiple pages makes it very difficult to keep the wiki current and virtually ensures that there will be misinformation published somewhere. Whenever possible, try to link back to the original DavisWiki source rather than duplicating information."

Wiki Style Guide

PhilipNeustrom — 2005-07-07 12:52:10

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 50:	Line 50:
- Thoughts? I'm not sure I'm phrasing this very concisely or clearly, so I'd appreciate any help.. --["PhilipNeustrom"]	+ Thoughts? I'm not sure I'm phrasing this very concisely or clearly, so I'd appreciate any help.. Maybe it would be best to just say "When editing, keep in mind the years to come and what will need to be updated and how difficult that may be."? --["PhilipNeustrom"]

Wiki Style Guide

PhilipNeustrom — 2005-07-07 12:49:25

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 48:	Line 48:
- Try to avoid segmenting and replicating information across pages. Putting the same information on a bunch of pages makes keeping information updated extremely difficult and also makes searching very hard. Keep the information about a particular topic on the page devoted to that topic, for the most part. General pages that collect information from specific pages are terrific and useful, but keep in mind that you want to minimize replication otherwise it will become harder, down the road, to keep it all updated.	+ Try to avoid segmenting and replicating information across pages. Putting the same information on a bunch of pages makes keeping information updated extremely difficult and also makes searching very hard. Keep the information about a particular topic on the page devoted to that topic, for the most part. General pages that collect information from specific pages are terrific and useful, but keep in mind that you want to minimize replication of things that changeg frequently otherwise it will become harder, down the road, to keep it all updated.
Line 50:	Line 50:
- Thoughts? --["PhilipNeustrom"]	+ Thoughts? I'm not sure I'm phrasing this very concisely or clearly, so I'd appreciate any help.. --["PhilipNeustrom"]

Wiki Style Guide

PhilipNeustrom — 2005-07-07 12:46:24

proposed simple addition

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 43:	Line 43:
	+ + ----- + ''I want to add the following, because I think it's important:'' + + == Building pages so searching works best == + Try to avoid segmenting and replicating information across pages. Putting the same information on a bunch of pages makes keeping information updated extremely difficult and also makes searching very hard. Keep the information about a particular topic on the page devoted to that topic, for the most part. General pages that collect information from specific pages are terrific and useful, but keep in mind that you want to minimize replication otherwise it will become harder, down the road, to keep it all updated. + + Thoughts? --["PhilipNeustrom"]

Wiki Style Guide

PhilipNeustrom — 2005-04-28 03:33:18

added click here phrase

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 40:	Line 40:
	+ * Avoid the use of "click here" or "go here" for link names. Descriptive and integrated names are best. Imagine that the page you're writing on is printed on a piece of paper. Would all the text still make sense?

Wiki Style Guide

ArlenAbraham — 2005-04-02 12:26:53

grammar. eric tell me if i'm wrong here.

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 39:	Line 39:
	+ * Names of books and movies are ''italicised'' rather than __underlined__. Underlining is reserved for writing things by hand or by typewriter when italics are impossible. Names of smaller, shorter works such as articles or songs within an album are surrounded by "double quotes." Also, punctuation marks ''always'' go inside the quotes unless you are posing a question which contains a quote. Ex: Did he really say "you're a floozy"?

Wiki Style Guide

PhilipNeustrom — 2005-02-13 19:22:41

i hope this clarifies a tad

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 20:	Line 20:
- Pages with peoples' NamesLikeThis are pages for people ''on'' the wiki to ''use''. Pages with Names Like This for people are pages for people from a more biographical standpoint.	+ Pages with peoples' NamesLikeThis are pages for people ''on'' the wiki to ''use''. Pages with Names Like This for people are pages for people from a more biographical standpoint. Generally, people put highly-personal or wiki-centric information on their ''own'' page. If they're a public figure, then ''other people'' are expected to control the content of the biographical page.

Wiki Style Guide

PhilipNeustrom — 2005-01-04 15:18:40

simple rule for people page names

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 18:	Line 18:
	+ + === Simple rule === + Pages with peoples' NamesLikeThis are pages for people ''on'' the wiki to ''use''. Pages with Names Like This for people are pages for people from a more biographical standpoint.

Wiki Style Guide

PhilipNeustrom — 2004-12-31 11:45:11

'please check', 'photo request' usage.

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 24:	Line 24:
	+ :)
Line 29:	Line 30:
- :)
Line 33:	Line 33:
- = Simple things =	+ = Simple conventions =
Line 35:	Line 35:
	+ * Want a fact checked? Write ''(please check)'' next to something you want checked. Want a photo taken? Write ''(photo request)'' next to something you want a photo of. Doing this will allow for determined folks to easily search for the phrases ''please check'' and ''photo request'' to find things to do.

Wiki Style Guide

PhilipNeustrom — 2004-12-24 17:26:01

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 33:	Line 33:
	+ = Simple things = + * Avoid use of the words "I" or "me" unless you are attributing text to yourself.

Wiki Style Guide

PhilipNeustrom — 2004-12-21 02:33:19

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 9:	Line 9:
- Sometimes it's not clear what the real name of the place/thing/idea you're making a page for ''should'' be. In these cases of confusion, just make a decision as to what the page name should be, then make note of the alternative possibilities in the page itself. Referring to the other possible names allows people to do searches and find the page under any of the possible names. An example of this is the ["24 Hour Reading Room"], which is known as both the "Extended Hours Reading Room" and the "24 Hour Reading Room". It's not clear what the name of the page should be, so a simple reference to the other name (somewhere in the page, probably toward the beginning) fixes this and allows people to find it in a '''search''' (searching is very important for people who don't use the site regularly).	+ Sometimes it's not clear what the real name of the place/thing/idea you're making a page for ''should'' be. In these cases of confusion, just make a decision as to what the page name should be, then make note of the alternative possibilities in the page itself. Referring to the other possible names allows people to do searches and find the page under any of the possible names. An example of this is the ["24 Hour Reading Room"], which is known as both the "Extended Hours Reading Room" and the "24 Hour Reading Room". It's not clear what the name of the page should be, so a simple reference to the other name (somewhere in the page, probably toward the beginning) fixes this and allows people to find it in a '''search''' (searching is very important for people who don't use the site regularly). Also, making redirects (by making the page contain only the line {{{#redirect The name of the page}}}) allows the other names to be used without problems -- they will simply redirect to the one page, whatever it happens to be named.

Wiki Style Guide

PhilipNeustrom — 2004-12-13 04:49:50

linked a few pages at the bottom

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 33:	Line 33:
-
Line 35:	Line 34:
- See also: [http://c2.com/cgi/wiki?GoodStyle Good Style]	+ See also: ["Wiki Ethics"], ["Davis Wiki Guide"] and [http://c2.com/cgi/wiki?GoodStyle Good Style].

Wiki Style Guide

PhilipNeustrom — 2004-12-07 19:52:20

note on integrating comments

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 17:	Line 17:
- Think of it this way: the username page is the page ''for'' that person. The page with the name spaced out is the page where historical information about them might go.	+ Think of it this way: the username page is the page ''for'' that person to use. The page with the name spaced out is the page where historical information about them might go.
Line 25:	Line 25:
- = Less Important Stuff =	+ = Layout Stuff =
Line 30:	Line 30:
	+ == Conversations and Comments == + Often times the conversations or comments inside of a page contribute a lot to the page's worth. If possible, integrate and re-structure the page to reflect the important information contained in comments. If a comment is directed at you and it's hardly valuable to anyone else after you've read it, then removing it un-clutters the page. Leaving the subjective/experience-based poritions of comments attributed to those who make them keeps (more) subjective knowledge around. +

Wiki Style Guide

PhilipNeustrom — 2004-12-07 18:43:31

good style link (so good!)

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 30:	Line 30:
	+ + ----- + See also: [http://c2.com/cgi/wiki?GoodStyle Good Style]

Wiki Style Guide

MikeIvanov — 2004-11-28 16:11:34

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 10:	Line 10:
	+ + ---- + What do you guys think of capitalizing the first word of a page name and leaving the rest lower-case unless it's a proper name? Personally, I think it looks much better. - ["MikeIvanov"]

Wiki Style Guide

PhilipNeustrom — 2004-11-15 22:20:28

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 11:	Line 11:
- == A little note on names for names. . ! ==	+ == A note on names for people ==

Wiki Style Guide

PhilipNeustrom — 2004-11-15 22:17:07

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 14:	Line 14:
	+ Think of it this way: the username page is the page ''for'' that person. The page with the name spaced out is the page where historical information about them might go. +

Wiki Style Guide

PhilipNeustrom — 2004-11-11 22:31:24

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 16:	Line 16:
- Searching is very important! Before you make a page you should do a search for it and similar items to make sure the page doesn't already exist. If the page already exists, add to it! If it exists but has (as you feel) the incorrect name, then feel free to Rename it (by going into Edit and pressing "Rename" down under the edit area) -- be sure to state your reason. After renaming the page you should change the old links to the old name to the new name -- again, by doing a search :) (search for the old page name)	+ Searching is very important! Before you make a page you should do a search for it and similar items to make sure the page doesn't already exist. If the page already exists, add to it! If it exists but has (as you feel) the incorrect name, then feel free to Rename it (by going into Edit and pressing "Rename" down under the edit area) -- be sure to state your reason. After renaming the page you should change the old links to the old name to the new name -- again, by doing a search :) (search for the old page name) -- note: you don't ''have'' to do this, as the old page name will automatically redirect to the new page name, but it's good style, and good style is sexy.

Wiki Style Guide

PhilipNeustrom — 2004-11-10 21:04:45

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 9:	Line 9:
- Sometimes it's not clear what the real name of the place/thing/idea you're making a page for ''should'' be. In these cases of confusion, just make a decision as to what the page name should be, then make note of the alternative possibilities in the page itself. Referring to the other possible names allows people to do searches and find the page under any of the possible names. An example of this is the ["24 Hour Reading Room"], which is known as both the "Extended Hours Reading Room" and the "24 Hour Reading Room". It's not clear what the name of the page should be, so a simple reference to the other name fixes this and allows people to find it in a '''search''' (searching is very important for people who don't use the site regularly).	+ Sometimes it's not clear what the real name of the place/thing/idea you're making a page for ''should'' be. In these cases of confusion, just make a decision as to what the page name should be, then make note of the alternative possibilities in the page itself. Referring to the other possible names allows people to do searches and find the page under any of the possible names. An example of this is the ["24 Hour Reading Room"], which is known as both the "Extended Hours Reading Room" and the "24 Hour Reading Room". It's not clear what the name of the page should be, so a simple reference to the other name (somewhere in the page, probably toward the beginning) fixes this and allows people to find it in a '''search''' (searching is very important for people who don't use the site regularly).

Wiki Style Guide

PhilipNeustrom — 2004-11-10 21:04:00

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 9:	Line 9:
- Sometimes it's not clear what the real name of the place/thing/idea you're making a page for ''should'' be. In these cases of confusion, just make a decision as to what the page name should be, then make note of the alternative possibilities in the page itself. Referring to the other possible names allows people to do searches and find the page under any of the possible names. An example of this is the ["24 Hour Reading Room"], which is known as both the "Extended Hours Reading Room" and the "24 Hour Reading Room". It's not clear what the name of the page should be, so a simple reference to the other name fixes this and allows people to find it in a search. Which brings us to our next excittting topic. . .	+ Sometimes it's not clear what the real name of the place/thing/idea you're making a page for ''should'' be. In these cases of confusion, just make a decision as to what the page name should be, then make note of the alternative possibilities in the page itself. Referring to the other possible names allows people to do searches and find the page under any of the possible names. An example of this is the ["24 Hour Reading Room"], which is known as both the "Extended Hours Reading Room" and the "24 Hour Reading Room". It's not clear what the name of the page should be, so a simple reference to the other name fixes this and allows people to find it in a '''search''' (searching is very important for people who don't use the site regularly).

Wiki Style Guide

PhilipNeustrom — 2004-11-10 21:02:32

(it's not important yet, but it might be a point of confusion later)

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 11:	Line 11:
	+ == A little note on names for names. . ! == + If you want to make a page about someone, say the UCD Chancellor, Larry Vanderhoef, you should probably name that page "Larry Vanderhoef" (note the space). When there are pages for people where their name ''isn't'' spaced out, such as {{{FirstnameLastname}}}, this is the page ''for'' that user -- for their ''username''. If you know they're going to sign up for the wiki, or if they aren't famous or really important at all, then it doesn't much matter. The with pages that have a ''username'' as their title are going to be the page associated with that user (it's up in their upper right hand corner all the time, it's automatically a link when they make an edit, etc).

Wiki Style Guide

JaimeRaba — 2004-11-04 08:33:17

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 11:	Line 11:
	+ +
Line 15:	Line 17:
	+ + = Less Important Stuff = + == Order of Lists == + Generally, when listing a bunch of links or just making a list in an article, they should be organized alphabetically, unless there is a good reason to do otherwise. +

Wiki Style Guide

PhilipNeustrom — 2004-11-03 19:05:45

does this help?

Differences for Wiki Style Guide

Deletions are marked with - .	Additions are marked with +.
Line 1:	Line 1:
	+ = Something to keep in mind = + Don't panic! These are just suggestions and you are under no obligation to follow them -- but keep in mind that others may decide to change your pages' names, links, and content to match these guidelines. We are trying to create a flexible, creative environment, but also one without a whole lot of confusion. This guide should be taken with a grain of salt. + + We never want guidelines to interfere with your ability or motivation for expressing yourself and getting your ideas out. Your ideas are the most important thing. This is a ''style guide'', which means it's just the style we try to aim for to make sure we're all on the same page when it comes to conventions. + + = What should I name my page? = + If you're making a page, picking a good name for it is important. If the place/idea has a ''proper'' name then you should try and make that the page name. For instance, Kerr Hall is often referred to as simply "Kerr" but you should make the page name "Kerr Hall" because this is the officially used name of the building. When you decide to link to Kerr, you can/should link to it with whatever name you want, be it ["Kerr Hall" Kerr], ["Kerr Hall"], or ["Kerr Hall" the Mathematics building]. When making a page for something without a universal name, just use the normal rules for capitalization in the English language. + + Sometimes it's not clear what the real name of the place/thing/idea you're making a page for ''should'' be. In these cases of confusion, just make a decision as to what the page name should be, then make note of the alternative possibilities in the page itself. Referring to the other possible names allows people to do searches and find the page under any of the possible names. An example of this is the ["24 Hour Reading Room"], which is known as both the "Extended Hours Reading Room" and the "24 Hour Reading Room". It's not clear what the name of the page should be, so a simple reference to the other name fixes this and allows people to find it in a search. Which brings us to our next excittting topic. . . + + = Search! = + Searching is very important! Before you make a page you should do a search for it and similar items to make sure the page doesn't already exist. If the page already exists, add to it! If it exists but has (as you feel) the incorrect name, then feel free to Rename it (by going into Edit and pressing "Rename" down under the edit area) -- be sure to state your reason. After renaming the page you should change the old links to the old name to the new name -- again, by doing a search :) (search for the old page name) + + = Be kind and courteous! = + :)