Difference between revisions of "Help:Editing"

From RealCTY
Jump to navigation Jump to search
Line 1: Line 1:
Before you take a stab at editing this site, make sure you understand how to edit.  Here are a few tips:
+
Before you take a stab at editing this site, make sure you understand how to edit.  Here are a few do's and don't's:
  
* '''Use correct spelling:''' This removes the hassle of moving poorly spelled pages.
+
'''Do:'''
* '''Use correct grammar:''' Try to make things understandable; unless you're going to be writing the entire article in completely unreadable chatspeek, don't do it at all.
 
* '''Use proper encyclopedic language:''' Much of the site has what might be considered a "casual reference" style.  Try to keep it this way.  Formal citations are not necessary, but generally formal language is preferred.  Certain areas of the site are excepted from this rule; see below for the list.
 
* '''Don't comment on articles:''' There's a reason that there's a tab marked "discussion" on every page.  This rule does not apply if the comment is for clarification or uncertain content.
 
* '''Learn about Wiki style:''' Wiki has its own editing style; go check Wikipedia's editing help for more information about linking, images, etc.  This especially applies to headings.  Don't use a <nowiki>"=="</nowiki> header followed by a <nowiki>"===="</nowiki> header; this screws up the table of contents.
 
* '''Keep pictures small:''' This site is privately payed for, and an overabundance of pictures will hike up costs.  Keep image uploads to the site small, also (Facebook photo album sized pictures is a good general guideline).
 
* '''Do not erase pages:''' Only admins can get rid of pages; however, anyone can wipe them clean.  Don't do this!  Most pages have a purpose; if a page has been spammed, please delete the spam only.  Also, if for some reason you must erase a page, summarize a reason for it.
 
* '''Do not vandalize pages:''' Annoying vandalizations and deformatting of pages will result in bannage.  Similarly, obvious spam (which tends to be enclosed in divs) results in immediate banning.
 
  
The best way to learn how to edit a page is to read [[Wikipedia:How_to_edit_a_page|Wikipedia's guide]].
+
* ''use correct spelling and grammar:''  This saves administrators and conscientious users the trouble of copy-editing, and improves readability.  Unless you're going to be writing the entire article in completely unreadable chatspeek, don't do it at all.
 +
* ''learn about Wikipedia style:''  Wikipedia has its own stylistic rules for editing, and most of them apply here; check its [[Wikipedia:Manual_of_Style|Manual of Style]] for more info.  MediaWiki also has its own markup language and formatting conventions, and you should take some time to familiarize yourself with them.  For instance, don't use a <nowiki>"=="</nowiki> header followed by a <nowiki>"===="</nowiki> header, since it screws up the table of contents.
 +
* ''use proper encyclopedic language:'' Much of the site has what might be considered a "casual reference" style.  Most articles are written with a casual tone, but nonetheless are written at a reasonably sophisticated level, are written in the third person, and should retain some degree of objectivity with respect to the subject.
 +
* ''keep pictures small:''  This site is paid-for privately, and an overabundance of large pictures will hike up costs.  Please keep image uploads to the site small (Facebook photo album sized pictures is a good general guideline).
 +
 
 +
'''Don't:'''
 +
 
 +
* ''comment on articles:''  There's a reason that there's a tab marked "discussion" on every page.  This rule does not apply if the comment is for clarification or uncertain content.
 +
* ''write yourself into articles:''  While individual experiences are certainly the heart of CTY, they are not the heart of this website.  RealCTY is a record of CTY culture from as objective as possible a viewpoint.  There are places on the site set aside for personal anecdotes or memories; see [[Help:Editing#Informal Site Areas|Informal Site Areas]] and [[Help:Editing#Shameless Egotism|Shameless Egotism]] for more details.
 +
* ''erase pages:''  Only admins can get rid of pages; however, anyone can wipe them clean.  Please don't do this!  Most pages have a purpose; if a page has been spammed, please delete the spam only.  Also, if for some reason you must erase a page, provide a reason.
 +
* ''vandalize pages:'' Annoying vandalizations and deformatting of pages will result in bannage.  Similarly, obvious spam (which tends to be enclosed in divs) results in immediate banning.
 +
 
 +
The best way to learn how to start editing is to read [[Wikipedia:How_to_edit_a_page|Wikipedia's guide]]. But before you start, read the guidelines on this page!
  
 
==Style==
 
==Style==
  
In general, Wikipedia's [[Wikipedia:Manual_of_Style|Manual of Style]] serves as a good guideline for editing RealCTY.  Some of the stylistic idiosyncrasies that have popped up at RealCTY, and which perhaps differ from Wikipedia style, are detailed below.
+
In general, Wikipedia's [[Wikipedia:Manual_of_Style|Manual of Style]] serves as a good guideline for editing RealCTY.  Make sure you understand wiki markup before doing any heavy editing; wiki markup (using <nowiki>'''text''' for bold and ''text'' for italics</nowiki> is preferred to using HTML tags.  Also, note that "br" tags are unnecessary when making a new paragraph, but they are for a single line break.  Please place "br" tags at the ends of lines, rather than at the beginnings of lines.  Also, close your tags ("br /").
 +
 
 +
Some of the stylistic idiosyncrasies that have popped up at RealCTY, and which perhaps differ from Wikipedia style, are detailed below.
  
 
===Titles===
 
===Titles===
Line 20: Line 27:
 
Wikipedia's [[Wikipedia:Manual_of_Style|Manual of Style]] explains how titles should be formatted in general.  To summarize some of the info most pertinent to RealCTY:
 
Wikipedia's [[Wikipedia:Manual_of_Style|Manual of Style]] explains how titles should be formatted in general.  To summarize some of the info most pertinent to RealCTY:
  
 +
* Titles should be spelled correctly.
 
* Page names should, in general, be in title case, meaning that first letters of important words are capitalized.  This is not really a fundamental part of RealCTY style, but rather occurs because most page names tend to take the form of proper noun phrases.
 
* Page names should, in general, be in title case, meaning that first letters of important words are capitalized.  This is not really a fundamental part of RealCTY style, but rather occurs because most page names tend to take the form of proper noun phrases.
 
* Page names should not usually contain quotes; however, in the case of pages about books, films, songs, or other such publications, references to the page or to the published work in the article should be quoted or italicized accordingly.
 
* Page names should not usually contain quotes; however, in the case of pages about books, films, songs, or other such publications, references to the page or to the published work in the article should be quoted or italicized accordingly.
Line 30: Line 38:
  
 
There is little more to say about this style issue than to identify it.  Wikipedians should avoid changing this format, and users should make sure to allocate information to the correct "subpage" (notably, all of the pages mentioned above constitute [[Help:Editing#Informal Site Areas|Informal Site Areas]]).
 
There is little more to say about this style issue than to identify it.  Wikipedians should avoid changing this format, and users should make sure to allocate information to the correct "subpage" (notably, all of the pages mentioned above constitute [[Help:Editing#Informal Site Areas|Informal Site Areas]]).
 +
 +
===Links===
 +
 +
Unlike Wikipedia, this site is relatively small, so linking is not ''absolutely'' necessary -- it is, however, encouraged.  However, if you like adding links (which is great), keep it to only one link to each page in any one article (e.g., if Lancaster is mentioned twice, only link to the site page once, preferably in the first or most important instance).
  
 
===Article Creation===
 
===Article Creation===
Line 37: Line 49:
 
Stubs are articles that are so short that, even if the subject of the article is noteworthy, the article itself is effectively useless.  Please do not create stub articles; if you have a short spiel about something CTY-related, put it under the correct category in the [[Lexicon]], unless the page is already on the [[Special:Wantedpages]] list (and even if it is, oftentimes it might be better in the Lexicon).  Sometimes, a bunch of stubs can be merged into a single page.  A prime example is the Cucumber Cult section of the [[Hall:CAR]] page, where many individual games were merged into the page about the student group in which they were most commonly played.
 
Stubs are articles that are so short that, even if the subject of the article is noteworthy, the article itself is effectively useless.  Please do not create stub articles; if you have a short spiel about something CTY-related, put it under the correct category in the [[Lexicon]], unless the page is already on the [[Special:Wantedpages]] list (and even if it is, oftentimes it might be better in the Lexicon).  Sometimes, a bunch of stubs can be merged into a single page.  A prime example is the Cucumber Cult section of the [[Hall:CAR]] page, where many individual games were merged into the page about the student group in which they were most commonly played.
  
Feel free to take things from the Lexicon and expand on them in full-fledged pages, though, if there is enough to say about them.
+
Moreover, please do not link to pages without the intention of starting them, and please do not make "placeholder" pages that read something like "This is a page about blah!"  In contrast, do feel free to take things from the Lexicon and expand on them in full-fledged pages, if there is enough to say about them.
  
 
====Redirects====
 
====Redirects====
  
Please create redirects with good judgment.  If you really think that someone is going to spell "[[Istanbul (Not Constantinople)]]" or "[[Istanbul]]" as "Istenbil," you probably don't belong here.  Moreover, please create useful redirects (e.g., "[[Egyptian Rat Screw]]" or "[[Egyptian rat screw]]") while avoiding useless ones (e.g., "Egyptian rat Screw" or "Egyptian Rat Stew" or "Eflipcork batface").
+
Please create redirects with good judgment.  If you really think that someone is going to spell "[[Istanbul (Not Constantinople)]]" or "[[Istanbul]]" as "Istenbil," you probably don't belong here.  In other words, please create useful redirects (e.g., "[[Egyptian Rat Screw]]" or "[[Egyptian rat screw]]" or "[[ERS]]") while avoiding useless ones (e.g., "Egyptian rat Screw" or "Egyptian Rat Stew" or "Eflipcork batface").
  
 
===Categories===
 
===Categories===
  
If you do create a new page, please categorize it properly.  Put it under a site or two if applicable (if it's all sites, don't put it under any sites).  Categorize it as a Game, an Activity, a Student Group, a Traditions, etc.  Things that don't fall into any category go under "General."
+
If ever you create a new page, please categorize it properly.  If the article is about some feature of only a few sites, categorize it under those sites (see [[Special:Categories]] for a list of categories).  Categorize it as a Game, an Activity, a Student Group, a Traditions, etc.  Things that don't fall into any category go under "General."
 +
 
 +
Please keep the categories at the bottom of the page to keep things organized.  In particular, if you are adding to the end of a page, do so above the category tags.
 +
 
 +
===Informal Site Areas===
 +
 
 +
For the most part, RealCTY is intended to be encyclopedic, or at least psuedoencyclopedic, in nature.  RealCTY functions as a record of CTY culture throughout the many years of its existence.  But CTY is, of course, more than just a compilation of cultural gems or traditions.  To reflect this, there is space on the site that is not meant to be encyclopedic.  These pages need not be edited for style and need not follow stylistic conventions to the letter, but please do your best to follow grammatical conventions to assist readability, as well as to use correct formatting.  These "informal site areas" include:
  
Try to keep the categories at the bottom of the page to keep things organized.
+
* [[Memories]] pages
 +
* [[Hall of Fame]] pages
 +
* [[Hall of Shame]] pages
 +
* Class History sections of [[Courses|Course]] pages
 +
* Staff pages (try to keep these appropriate, unless everybody really, really hates the staff member)
 +
* Student Groups pages
  
 
==Content==
 
==Content==
Line 56: Line 79:
  
 
Writing yourself into contended articles or creating articles about yourself is against editing policy and abuse of this rule will, in fact, result in a ban.  Occasionally, some people do things [[Duck|so memorable]] that they actually become a part of CTY culture, and hence there are some names in articles.  Otherwise, there are spaces set aside for talking about your own experiences.  These include userpages, [[Memories]] pages, [[Hall pages]], and the Class History sections of [[Courses|Course]] pages, as well as talk pages.  Please make use of these instead of writing "One time, Billy had a red spoon instead of a white one, and everyone loved him!" in the [[Blammo]] page.
 
Writing yourself into contended articles or creating articles about yourself is against editing policy and abuse of this rule will, in fact, result in a ban.  Occasionally, some people do things [[Duck|so memorable]] that they actually become a part of CTY culture, and hence there are some names in articles.  Otherwise, there are spaces set aside for talking about your own experiences.  These include userpages, [[Memories]] pages, [[Hall pages]], and the Class History sections of [[Courses|Course]] pages, as well as talk pages.  Please make use of these instead of writing "One time, Billy had a red spoon instead of a white one, and everyone loved him!" in the [[Blammo]] page.
 
===Informal Site Areas===
 
 
For the most part, RealCTY is intended to be encyclopedic, or at least psuedoencyclopedic, in nature.  RealCTY functions as a record of CTY culture throughout the many years of its existence.  However, CTY itself is not just about its culture and traditions, but about individual experiences and moments and memories.  Hence, certain parts of the site are set aside for this purpose.  These sections of the site
 
 
* Memories pages
 
* Hall of Fame pages (admins: continue to patrol for "importance" and move to memories as needed)
 
* Hall of Shame pages (same as above)
 
* Class History sections of Course pages
 
* Staff pages (please keep them appropriate!)
 
* Student Groups pages (again, patrol for importance among newer groups)
 
  
 
However, please note that articles about individual students or halls are still not allowed unless they did something like hack the iPhone or create a Canon dance.  Admins are requested to move pages that are too narrow in scope to the Memories pages, or to delete them.
 
However, please note that articles about individual students or halls are still not allowed unless they did something like hack the iPhone or create a Canon dance.  Admins are requested to move pages that are too narrow in scope to the Memories pages, or to delete them.
 
===Links===
 
 
Unlike Wikipedia, this site is relatively small, so linking is not ''absolutely'' necessary - it is, however, encouraged.  However, if you like adding links (which is great), keep it to only one link to each page in any one article (e.g., if Lancaster is mentioned twice, only link to the site page once, preferably the first or most important time).
 
 
===HTML and Wiki Markup===
 
 
Make sure you understand Wiki's editing format.  Note that wiki markup (using <nowiki>'''text''' for bold and ''text'' for italics</nowiki> is preferred to using HTML tags.  Also, note that "br" tags are unnecessary when making a new paragraph, but they are for a single line break.  Please place "br" tags at the ends of lines, rather than at the beginning of the next line.  Also, close your tags ("br /").
 
  
 
===Userpages===
 
===Userpages===
Line 88: Line 92:
  
 
Keep things alphabetical, and brief.  Do not simply copy an article onto the Lexicon.  Especially refrain from doing the opposite, and copying Lexicon stubs into full-fledged article pages; this is unnecessary and becomes a hassle.
 
Keep things alphabetical, and brief.  Do not simply copy an article onto the Lexicon.  Especially refrain from doing the opposite, and copying Lexicon stubs into full-fledged article pages; this is unnecessary and becomes a hassle.
 
===Userpages===
 
 
Make userpages instead of articles about users.
 
 
===Placeholders===
 
 
Placeholders are fine.  Stubs are not.  If you want to link to a page that hasn't been created yet, that's fine, but don't create the page and just write, "This page does not exist" on it.  Try not to link to pages if you have no intention of making them.
 
 
===Security===
 
 
Editing, creating pages, etc. has been limited to logged-in users.  This makes it easier to warn and track users who have vandalized pages, have made formatting errors, etc.  Sorry for any inconveniences caused by this, but you ought to make accounts anyway.  Yaaaay for accounts!
 

Revision as of 17:35, 27 June 2010

Before you take a stab at editing this site, make sure you understand how to edit. Here are a few do's and don't's:

Do:

  • use correct spelling and grammar: This saves administrators and conscientious users the trouble of copy-editing, and improves readability. Unless you're going to be writing the entire article in completely unreadable chatspeek, don't do it at all.
  • learn about Wikipedia style: Wikipedia has its own stylistic rules for editing, and most of them apply here; check its Manual of Style for more info. MediaWiki also has its own markup language and formatting conventions, and you should take some time to familiarize yourself with them. For instance, don't use a "==" header followed by a "====" header, since it screws up the table of contents.
  • use proper encyclopedic language: Much of the site has what might be considered a "casual reference" style. Most articles are written with a casual tone, but nonetheless are written at a reasonably sophisticated level, are written in the third person, and should retain some degree of objectivity with respect to the subject.
  • keep pictures small: This site is paid-for privately, and an overabundance of large pictures will hike up costs. Please keep image uploads to the site small (Facebook photo album sized pictures is a good general guideline).

Don't:

  • comment on articles: There's a reason that there's a tab marked "discussion" on every page. This rule does not apply if the comment is for clarification or uncertain content.
  • write yourself into articles: While individual experiences are certainly the heart of CTY, they are not the heart of this website. RealCTY is a record of CTY culture from as objective as possible a viewpoint. There are places on the site set aside for personal anecdotes or memories; see Informal Site Areas and Shameless Egotism for more details.
  • erase pages: Only admins can get rid of pages; however, anyone can wipe them clean. Please don't do this! Most pages have a purpose; if a page has been spammed, please delete the spam only. Also, if for some reason you must erase a page, provide a reason.
  • vandalize pages: Annoying vandalizations and deformatting of pages will result in bannage. Similarly, obvious spam (which tends to be enclosed in divs) results in immediate banning.

The best way to learn how to start editing is to read Wikipedia's guide. But before you start, read the guidelines on this page!

Style

In general, Wikipedia's Manual of Style serves as a good guideline for editing RealCTY. Make sure you understand wiki markup before doing any heavy editing; wiki markup (using '''text''' for bold and ''text'' for italics is preferred to using HTML tags. Also, note that "br" tags are unnecessary when making a new paragraph, but they are for a single line break. Please place "br" tags at the ends of lines, rather than at the beginnings of lines. Also, close your tags ("br /").

Some of the stylistic idiosyncrasies that have popped up at RealCTY, and which perhaps differ from Wikipedia style, are detailed below.

Titles

Wikipedia's Manual of Style explains how titles should be formatted in general. To summarize some of the info most pertinent to RealCTY:

  • Titles should be spelled correctly.
  • Page names should, in general, be in title case, meaning that first letters of important words are capitalized. This is not really a fundamental part of RealCTY style, but rather occurs because most page names tend to take the form of proper noun phrases.
  • Page names should not usually contain quotes; however, in the case of pages about books, films, songs, or other such publications, references to the page or to the published work in the article should be quoted or italicized accordingly.

One notable difference between RealCTY titles and Wikipedia titles concerns the bolding of the title at the start of a page. The content of every regular article should begin with the article's title, or some variation of it, and should be bolded. However, whereas Wikipedia accomplishes this with bold markup (three single-quotes on either side, i.e., '''Title'''), here at RealCTY, we instead use link notation (two square brackets flanking the target text, i.e., [[Title]]). We do this because this is what I decided to do a long time ago, and so now it is law, apparently. Please keep titles formatted in this manner; if the first word is a slight variant of the title, use piped links or other formatting shorthand (e.g., [[Title|Title variation]] or [[Title]]s).

Subpages

Some Wikipedia pages branch out into subpages, the titles of which typically take the form of Title/subtitle (where Title is the superpage). This construct is rarely of use here at RealCTY (for what I think is the sole example, see RealCTY:Alumni_Association/archive). Instead, due to some vestigial remains of a long-forgotten era of the site, we do have several pages which seem to have a related branch structure. These take the form of "fake prefixes" (real prefixes include RealCTY:, Talk:, Usertalk:, User:, Help:, etc.). These "prefixes" include Hall of Fame:, Hall of Shame:, Memories:, and Hall:. Each of them is followed by a three-letter site code. Former fake prefixes included Course:, Site:, and Song:.

There is little more to say about this style issue than to identify it. Wikipedians should avoid changing this format, and users should make sure to allocate information to the correct "subpage" (notably, all of the pages mentioned above constitute Informal Site Areas).

Links

Unlike Wikipedia, this site is relatively small, so linking is not absolutely necessary -- it is, however, encouraged. However, if you like adding links (which is great), keep it to only one link to each page in any one article (e.g., if Lancaster is mentioned twice, only link to the site page once, preferably in the first or most important instance).

Article Creation

Stubs

Stubs are articles that are so short that, even if the subject of the article is noteworthy, the article itself is effectively useless. Please do not create stub articles; if you have a short spiel about something CTY-related, put it under the correct category in the Lexicon, unless the page is already on the Special:Wantedpages list (and even if it is, oftentimes it might be better in the Lexicon). Sometimes, a bunch of stubs can be merged into a single page. A prime example is the Cucumber Cult section of the Hall:CAR page, where many individual games were merged into the page about the student group in which they were most commonly played.

Moreover, please do not link to pages without the intention of starting them, and please do not make "placeholder" pages that read something like "This is a page about blah!" In contrast, do feel free to take things from the Lexicon and expand on them in full-fledged pages, if there is enough to say about them.

Redirects

Please create redirects with good judgment. If you really think that someone is going to spell "Istanbul (Not Constantinople)" or "Istanbul" as "Istenbil," you probably don't belong here. In other words, please create useful redirects (e.g., "Egyptian Rat Screw" or "Egyptian rat screw" or "ERS") while avoiding useless ones (e.g., "Egyptian rat Screw" or "Egyptian Rat Stew" or "Eflipcork batface").

Categories

If ever you create a new page, please categorize it properly. If the article is about some feature of only a few sites, categorize it under those sites (see Special:Categories for a list of categories). Categorize it as a Game, an Activity, a Student Group, a Traditions, etc. Things that don't fall into any category go under "General."

Please keep the categories at the bottom of the page to keep things organized. In particular, if you are adding to the end of a page, do so above the category tags.

Informal Site Areas

For the most part, RealCTY is intended to be encyclopedic, or at least psuedoencyclopedic, in nature. RealCTY functions as a record of CTY culture throughout the many years of its existence. But CTY is, of course, more than just a compilation of cultural gems or traditions. To reflect this, there is space on the site that is not meant to be encyclopedic. These pages need not be edited for style and need not follow stylistic conventions to the letter, but please do your best to follow grammatical conventions to assist readability, as well as to use correct formatting. These "informal site areas" include:

  • Memories pages
  • Hall of Fame pages
  • Hall of Shame pages
  • Class History sections of Course pages
  • Staff pages (try to keep these appropriate, unless everybody really, really hates the staff member)
  • Student Groups pages

Content

Shameless Egotism

CTY should make you feel special. If CTY doesn't make you feel special, it's not doing it's job right, or you are somehow doing your job very very wrong (the former is more likely). You should feel like all the things that you did during session were the most important things ever, and this is both good and true, in its way. However, that doesn't mean that everything you've done ought to be mentioned on a site that documents, for the most part, factual information on CTY culture.

Writing yourself into contended articles or creating articles about yourself is against editing policy and abuse of this rule will, in fact, result in a ban. Occasionally, some people do things so memorable that they actually become a part of CTY culture, and hence there are some names in articles. Otherwise, there are spaces set aside for talking about your own experiences. These include userpages, Memories pages, Hall pages, and the Class History sections of Course pages, as well as talk pages. Please make use of these instead of writing "One time, Billy had a red spoon instead of a white one, and everyone loved him!" in the Blammo page.

However, please note that articles about individual students or halls are still not allowed unless they did something like hack the iPhone or create a Canon dance. Admins are requested to move pages that are too narrow in scope to the Memories pages, or to delete them.

Userpages

Userpages are meant for the pages of users. If you want to create a page about a person, that's fine, but there are two restrictions:

  1. If you are making a page about yourself, create an account and put your info on your userpage if possible. Do not make an article about you if you have an account. Also, don't redirect an article with your name to your userpage; just change all existing links to re-link to your userpage.
  2. If you are making a page about somebody else, do not give the title the prefix "User:". This is completely unnecessary, and also disrupts the naming system, especially since it leads to the belief in nonexistant users, as well as causing possible problems if a user creates an account under that name.

Lexicon

Keep things alphabetical, and brief. Do not simply copy an article onto the Lexicon. Especially refrain from doing the opposite, and copying Lexicon stubs into full-fledged article pages; this is unnecessary and becomes a hassle.