commit d504d428723ef0dd27a946312e68aa5fc5fbd313 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Tue Aug 15 08:47:40 2023 -0400 Updates diff --git a/references.md b/references.md index b44d2fd..3f19411 100644 --- a/references.md +++ b/references.md @@ -1,6 +1,6 @@ --- pagetitle: Writing the References -version: 1.7 +version: 1.8 --- # Writing the References @@ -57,26 +57,24 @@ alphabetic order (if using an alphabetic scheme). * Citing games - [ACM CHI Play](https://chiplay.acm.org/2020/guidelines/) has recommendations on -citing games as scholarly work. Below is an example: +citing games as scholarly work. For example: "Nintendo R&D1 and +Intelligent Systems. 1994. Super Metroid. Game [SNES]. (18 April +1994). Nintendo, Kyoto, Japan. Last played August 2011." -> Nintendo R&D1 and Intelligent Systems. 1994. Super Metroid. Game -> [SNES]. (18 April 1994). Nintendo, Kyoto, Japan. Last played August -> 2011. - -The `@Misc` tag should be used for BibTex. Below is the same -example as above: + The `@Misc` tag should be used for BibTex. Below is the same + example as above: ``` -@Misc{game, - Address = {Kyoto, Japan}, - Author = {"Nintendo R\&D1 and Intelligent Systems"}, - Month = {April}, - Day = {18}, - Howpublished = {Game [SNES]}, - Note = {Nintendo, Kyoto, Japan. Last played August 2011.}, - Publisher = {Nintendo}, - Title = {\emph{Super Metroid}}, - Year = {1994} -} + @Misc{game, + Address = {Kyoto, Japan}, + Author = {"Nintendo R\&D1 and Intelligent Systems"}, + Month = {April}, + Day = {18}, + Howpublished = {Game [SNES]}, + Note = {Nintendo, Kyoto, Japan. Last played August 2011.}, + Publisher = {Nintendo}, + Title = {\emph{Super Metroid}}, + Year = {1994} + } ``` commit 5711616bce22c7971f40af8153c60b8e3457fc76 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Tue Aug 15 08:21:47 2023 -0400 Updates diff --git a/references.md b/references.md index cf25b23..b44d2fd 100644 --- a/references.md +++ b/references.md @@ -1,6 +1,6 @@ --- pagetitle: Writing the References -version: 1.6 +version: 1.7 --- # Writing the References @@ -55,3 +55,28 @@ it. * Cited sources should appear in numeric order (if using numbering) or alphabetic order (if using an alphabetic scheme). +* Citing games - [ACM CHI +Play](https://chiplay.acm.org/2020/guidelines/) has recommendations on +citing games as scholarly work. Below is an example: + +> Nintendo R&D1 and Intelligent Systems. 1994. Super Metroid. Game +> [SNES]. (18 April 1994). Nintendo, Kyoto, Japan. Last played August +> 2011. + +The `@Misc` tag should be used for BibTex. Below is the same +example as above: + +``` +@Misc{game, + Address = {Kyoto, Japan}, + Author = {"Nintendo R\&D1 and Intelligent Systems"}, + Month = {April}, + Day = {18}, + Howpublished = {Game [SNES]}, + Note = {Nintendo, Kyoto, Japan. Last played August 2011.}, + Publisher = {Nintendo}, + Title = {\emph{Super Metroid}}, + Year = {1994} +} +``` + commit ec8281556625f5120db40da1163bc0f8fa8ad0b0 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Wed May 10 06:41:58 2023 -0400 Updates diff --git a/references.md b/references.md index 075d666..cf25b23 100644 --- a/references.md +++ b/references.md @@ -1,6 +1,6 @@ --- pagetitle: Writing the References -version: 1.5 +version: 1.6 --- # Writing the References @@ -11,13 +11,15 @@ appendix). * You only need to included cited sources, not necessarily any source you read. -* Style/format does not matter (e.g., APA or MLA). But *be -consistent* within your own format. e.g., if you italicize publishing -venue, do so every time. e.g., if titles are in quotes, make them -always in quotes. +* Style/format does not matter (e.g., APA or MLA). But **be +consistent** within your own format. e.g., 1) if you italicize +publishing venue, do so every time, 2) if titles are in quotes, make +them always in quotes, 3) if authors have full names versus initials, +do so every time. -> *Tip:* Double-check capitalization of titles. Have either "Titles -> words are not in caps" or "Titles Words are in Caps" but not both. +> *Tip:* Double-check capitalization of paper titles. Have *either* +> "Title words are not in caps" for all entries or "Titles Words are +> in Caps" for all entries but **not** both. * If you find a document on the Web, don't just use the URL for the citation. Follow through to get as much information as you can about @@ -35,18 +37,18 @@ it. + Journals should have volume and number + Web pages identified by a URL are the worst documents to cite - since they are ephemeral. But if you need to cite them, include as - much information as possible: + since they are ephemeral. But if you need to cite them, include + as much information as possible: - author - - title + - web page title - date accessed - date modified - publisher/source company - ... + All print sources should include page numbers/counts, where - possible + available + Everything should have a year commit 68f13691d8914a7595980e9b92dbf27816c17ddb Author: Mark Claypool <claypool@cs.wpi.edu> Date: Wed Mar 22 09:06:27 2023 -0400 Updates diff --git a/references.md b/references.md index ebf99c9..075d666 100644 --- a/references.md +++ b/references.md @@ -1,9 +1,9 @@ --- pagetitle: Writing the References -version: 1.4 +version: 1.5 --- -# References +# Writing the References * The references section goes last in the report (but before any appendix). commit 53559a59193f621f9a5d318bea527d5da23a0cff Author: Mark Claypool <claypool@cs.wpi.edu> Date: Wed Mar 22 09:04:53 2023 -0400 Updates diff --git a/references.md b/references.md index ff9ee7a..ebf99c9 100644 --- a/references.md +++ b/references.md @@ -1,11 +1,12 @@ --- pagetitle: Writing the References -version: 1.3 +version: 1.4 --- -# Writing the References +# References -* References go last in the report (but before any appendix). +* The references section goes last in the report (but before any +appendix). * You only need to included cited sources, not necessarily any source you read. @@ -20,9 +21,9 @@ always in quotes. * If you find a document on the Web, don't just use the URL for the citation. Follow through to get as much information as you can about -the *original* source. +the *original* source. See below. -* Include full Bibliographic information from the original source. +* Include **full bibliographic information** from the original source. The intent is to make it clear where the source came from in the References section itself *and* make it likely someone else can find it. @@ -41,12 +42,13 @@ it. - title - date accessed - date modified + - publisher/source company - ... + All print sources should include page numbers/counts, where - possible. + possible - + Everything should have a year. + + Everything should have a year * Cited sources should appear in numeric order (if using numbering) or alphabetic order (if using an alphabetic scheme). commit 0a3a035cc794a63af63c86c0c68decfdb2d808f2 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Mon Aug 8 13:58:58 2022 -0400 Updates diff --git a/references.md b/references.md index 101ced4..ff9ee7a 100644 --- a/references.md +++ b/references.md @@ -1,6 +1,9 @@ -# Project References Guidelines +--- +pagetitle: Writing the References +version: 1.3 +--- -v1.2 +# Writing the References * References go last in the report (but before any appendix). commit f502db686b62f8a70f73d56036f1e609139e00d5 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Wed Dec 29 13:12:30 2021 -0500 Updates diff --git a/references.md b/references.md index 1dc564f..101ced4 100644 --- a/references.md +++ b/references.md @@ -1,6 +1,6 @@ # Project References Guidelines -v1.1 +v1.2 * References go last in the report (but before any appendix). @@ -8,19 +8,19 @@ v1.1 you read. * Style/format does not matter (e.g., APA or MLA). But *be -consistent* within your own format. If you italicize publishing -venue, do so every time. If titles are in quotes, make them always in -quotes. +consistent* within your own format. e.g., if you italicize publishing +venue, do so every time. e.g., if titles are in quotes, make them +always in quotes. > *Tip:* Double-check capitalization of titles. Have either "Titles -> are in caps" or "Titles are in Caps" but not both. +> words are not in caps" or "Titles Words are in Caps" but not both. * If you find a document on the Web, don't just use the URL for the citation. Follow through to get as much information as you can about the *original* source. -* Include full Bibliographic information from original source. The -intent is to make it clear where the source came from in the +* Include full Bibliographic information from the original source. +The intent is to make it clear where the source came from in the References section itself *and* make it likely someone else can find it. @@ -47,3 +47,4 @@ it. * Cited sources should appear in numeric order (if using numbering) or alphabetic order (if using an alphabetic scheme). + commit 783163ca47ee8ce70845f73258b0fb5d39374a7f Author: Mark Claypool <claypool@cs.wpi.edu> Date: Tue Mar 12 11:55:04 2019 -0400 Updates diff --git a/references.md b/references.md index f07cdb3..1dc564f 100644 --- a/references.md +++ b/references.md @@ -1,41 +1,49 @@ # Project References Guidelines -v1.0 -+ References go last in the report (but before any appendix). +v1.1 -+ You only need to included cited sources, not necessarily any source +* References go last in the report (but before any appendix). + +* You only need to included cited sources, not necessarily any source you read. -+ Style/format does not matter (e.g., APA or MLA). But *be +* Style/format does not matter (e.g., APA or MLA). But *be consistent* within your own format. If you italicize publishing venue, do so every time. If titles are in quotes, make them always in quotes. - *Tip:* Double-check capitalization of titles. Have either "Titles - are in caps" or "Titles are in Caps" but not both. +> *Tip:* Double-check capitalization of titles. Have either "Titles +> are in caps" or "Titles are in Caps" but not both. + +* If you find a document on the Web, don't just use the URL for the +citation. Follow through to get as much information as you can about +the *original* source. -+ Include full Bibliographic information. The intent is to make it -clear where the source came from and make it likely someone else can -find it. +* Include full Bibliographic information from original source. The +intent is to make it clear where the source came from in the +References section itself *and* make it likely someone else can find +it. - + Conferences should have venue (city, state, country) + + Conferences should have venue (city, state, country) - + Books should include publisher + + Books should include publisher - + Journals should have volume and number - - + Web pages identified by a URL are the worst documents to cite - since they are ephemeral. But if you need to cite them, include as - much information as possible: - - author - - title - - date accessed - - date modified - - ... + + Journals should have volume and number + + + Web pages identified by a URL are the worst documents to cite + since they are ephemeral. But if you need to cite them, include as + much information as possible: + + - author + - title + - date accessed + - date modified + - ... - + All print sources should include page numbers/counts, where - possible. + + All print sources should include page numbers/counts, where + possible. + + + Everything should have a year. -+ Cited sources should appear in numeric order (if using numbering) or +* Cited sources should appear in numeric order (if using numbering) or alphabetic order (if using an alphabetic scheme). - commit a7f8202c3b85d9cb988067b774f736150d5023b2 Author: Mark Claypool <claypool@cs.wpi.edu> Date: Sat Feb 16 07:33:19 2019 -0500 Updates diff --git a/references.md b/references.md new file mode 100644 index 0000000..f07cdb3 --- /dev/null +++ b/references.md @@ -0,0 +1,41 @@ +# Project References Guidelines +v1.0 + ++ References go last in the report (but before any appendix). + ++ You only need to included cited sources, not necessarily any source +you read. + ++ Style/format does not matter (e.g., APA or MLA). But *be +consistent* within your own format. If you italicize publishing +venue, do so every time. If titles are in quotes, make them always in +quotes. + + *Tip:* Double-check capitalization of titles. Have either "Titles + are in caps" or "Titles are in Caps" but not both. + ++ Include full Bibliographic information. The intent is to make it +clear where the source came from and make it likely someone else can +find it. + + + Conferences should have venue (city, state, country) + + + Books should include publisher + + + Journals should have volume and number + + + Web pages identified by a URL are the worst documents to cite + since they are ephemeral. But if you need to cite them, include as + much information as possible: + - author + - title + - date accessed + - date modified + - ... + + + All print sources should include page numbers/counts, where + possible. + ++ Cited sources should appear in numeric order (if using numbering) or +alphabetic order (if using an alphabetic scheme). +