Adding a Reference: Difference between revisions

From Cybersecurity Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(46 intermediate revisions by 3 users not shown)
Line 1: Line 1:
To add a new bibliographic reference entry:
{{Header_Message|message=This page is undergoing revision, thank you for your patience.}}


1) Search for information on the reference including links to accessible copies online, reviews,  
<!--'''To add a new bibliographic reference entry:'''
 
=== 1. Research the Reference ===
Search for information on the reference including links to accessible copies online, reviews,  
discussions and/or the web site of the author or sponsor.  
discussions and/or the web site of the author or sponsor.  


2) Next create the BibTeX entry for the reference.  (See [[Guidelines for adding Bibliography entries]].)
=== 2. Create a BibTex Entry for the reference ===
Next create the BibTeX entry for the reference.  (See [[Guidelines for adding Bibliography entries]].)


3) Create a blank page for the reference.  To do this within the wiki format, you need to choose  
=== 3. Create a blank Wiki page for the reference ===
an existing page to create the link.  Normally, this will be a category page, however, if you are
To do this within the wiki format, you need to choose an existing page to create the link on.  Normally, you will enter the reference into the listing of all references on the [[Cybersecurity Annotated Bibliography]].  Enter a new table entry in the correct alphabetical order by first (if more than one) author's last name (see next paragraph). The initial entry does not have to be complete (since some information will not yet be available such as level of expertise), however leave blank table entries ("|  |") for missing data.
unsure of what categories will be appropriate, you could enter it
into the listing of all references on the [[Cybersecurity Annotated Bibliography]].   


The title of the new reference page will normally be the short version of the reference title.  For  
'''The title of the new reference page will normally be the short version of the reference title.''' For  
example, if the title of the reference is "''Pricing Security: Vulnerabilities as Externalities'',"  
example, if the title of the reference is "''Pricing Security: Vulnerabilities as Externalities'',"  
the page will be named [[Pricing Security]].  The exception will be where that page already exists  
the page will be named [[Pricing Security]].  The exception will be where that page already exists  
([[Cyberwar]] for example), in which case you will need to include the subtitle to create a unique page name.
([[Cyberwar]] for example), in which case you will need to include the subtitle (or some other distinguishing text) to create a unique page name.


4) Clicking on your newly created link will open a blank editing page (if it does not then you need to  
'''Click on your newly created link.''' This should open a blank editing page (if it does not then you need to  
come up with a new unique page name).  Copy and paste the contents of the [[TemplateForSources | sample template]]  
come up with a new unique page name).   
 
'''Copy and paste''' the contents of the [[TemplateForSources | sample template]]  
or some other reference page similar to the new reference into the newly created page.  You should  
or some other reference page similar to the new reference into the newly created page.  You should  
copy the source of the template (by selecting the "edit" tab) rather than the displayed page text.
copy the ''source'' of the template (by selecting the "edit" tab) rather than the displayed page text.


5) Begin editing the template.  The "Full Title of Reference" should contain both the main title and any
=== 4. Begin editing the template ===
subtitle separated by a colon.
(Note: You may find it easier to enter all the template information except for "Categorization" and "Keywords," then go back and complete these two sections last.)


6) The full citation should consists of the bluebook formatted citation for the reference followed by a link to
==== 4.1 Full Title of Reference ====
the full text of the reference if available labeled as ''Web'' or ''SSRN'' depending if the link goes directly to the  
The "Full Title of Reference" should contain both the main title and any subtitle separated by a colon.
 
E.g, Even though the wiki reference page is [[Four Grand Challenges in Trustworthy Computing]], the full title would be "Four Grand Challenges in Trustworthy Computing: Second in a Series of Conferences on Grand Research Challenges in Computer Science and Engineering."
 
==== 4.2 Full Citation ====
The full citation should consists of the bluebook formatted citation for the reference followed by a link to
the full text of the reference if available labeled as ''Web'' or ''SSRN'' depending on whether the link goes directly to the  
text or to an intermediate SSRN page.  This link should appear on the same line as the citation.  If there is a second
text or to an intermediate SSRN page.  This link should appear on the same line as the citation.  If there is a second
source for the full text of the reference, it should follow labled as ''AltWeb''.
source for the full text of the reference, it should follow, labled as ''AltWeb''.


(An example of the use of ''AltWeb'' is available at [[Why Information Security is Hard]].)
(An example of the use of ''AltWeb'' is available at [[Why Information Security is Hard]].)


(An example of the use of ''SSRN'' is available at [[Overcoming Impediments to Information Sharing]].
(An example of the use of ''SSRN'' is available at [[Overcoming Impediments to Information Sharing]].)


Note that ''Web'', ''AltWeb'', ''SSRN'', ''BibTex'' all are italicized.
Note that ''Web'', ''AltWeb'', ''SSRN'', ''BibTex'' all are italicized.


7) On a separate line (place one blank line after the citation to force the Wiki to line space), put the following as applicable:
On a separate line (place one blank line after the citation to force the Wiki to line space), put the following as applicable:


a) A link to the ''BibTeX'' entry for the reference (this should show only a single BibTeX entry in detail format - e.g. [http://cyber.law.harvard.edu/cybersecurity/Special:Bibliography?f=wikibiblio.bib&title=Special:Bibliography&view=detailed&action=&keyword=DoD:2007 ''BibTeX'']
* A link to the ''BibTeX'' entry for the reference (this should show only a single BibTeX entry in detail format - e.g. [http://cyber.law.harvard.edu/cybersecurity/Special:Bibliography?f=wikibiblio.bib&title=Special:Bibliography&view=detailed&action=&keyword=DoD:2007 ''BibTeX'']


b) A link to the ''Google Book''s entry for the reference, e.g., [http://books.google.com/books?id=ILaY4jBWXfcC&dq=Security+Engineering&ei=1NFRTNz5KJeMygTr6dDqBQ&cd=1 ''Google Books'']  (This can often be found in the BibTeX entry.)
* A link to the ''Google Book''s entry for the reference, e.g., [http://books.google.com/books?id=ILaY4jBWXfcC&dq=Security+Engineering&ei=1NFRTNz5KJeMygTr6dDqBQ&cd=1 ''Google Books'']  (This can often be found in the BibTeX entry.)


c) A link to the ''WorldCat'' entry for the reference, e.g., [http://www.worldcat.org/title/security-engineering-a-guide-to-building-dependable-distributed-systems-second-edition/oclc/639194438&referer=brief_results ''World Cat''].
* A link to the ''WorldCat'' entry for the reference, e.g., [http://www.worldcat.org/title/security-engineering-a-guide-to-building-dependable-distributed-systems-second-edition/oclc/639194438&referer=brief_results ''World Cat''].


d) A link to ''Amazon''.com's page for the reference (since this often contains useful reviews and other information about the work), e.g, [http://www.amazon.com/Security-Engineering-Building-Dependable-Distributed/dp/0470068523/ref=sr_1_1?ie=UTF8&s=books&qid=1280430777&sr=8-1 ''Amazon''].
* A link to ''Amazon''.com's page for the reference (since this often contains useful reviews and other information about the work), e.g, [http://www.amazon.com/Security-Engineering-Building-Dependable-Distributed/dp/0470068523/ref=sr_1_1?ie=UTF8&s=books&qid=1280430777&sr=8-1 ''Amazon''].


(See [[Security Engineering]] for an example that contains all of these links.)
(See [[Security Engineering]] for an example that contains all of these links.)


8) Create links to the appropriate categories for the reference.  When you add a category to the reference page, you must also place a link to the reference page  
==== 4.3 Categorization ====
Note: ''Categories refer to the major themes of the reference.''  If the reference only mentions a category in passing but does not focus on it, then it need not be included.
 
'''Create links to the appropriate categories for the reference.''' When you add a link to a category to the reference page, you must also place a link back to the reference page  
into the [[Table of Contents]] page for that category and ''every Table of Contents page higher in the hierarchy''.  So, for example, if you categorize the reference  
into the [[Table of Contents]] page for that category and ''every Table of Contents page higher in the hierarchy''.  So, for example, if you categorize the reference  
under TOC-> Issues-> Economics of Cybersecurity->Insurance, then links to it must appear under [[Insurance]], [[Economics of Cybersecurity]] and [[Issues]].  Links from
under TOC-> Issues-> Economics of Cybersecurity->Insurance, then links to it must appear under [[Insurance]], [[Economics of Cybersecurity]] and [[Issues]].  Links from
TOC Category pages back to the reference page should follow the table format shown in the TOC.  If more than two authors, abbreviate to "<first author> et. al"
TOC Category pages back to the reference page should follow the table format shown in the TOC.  If more than two authors, abbreviate to "<first author> et. al"


a) Categories should be separated by top level Table of Contents topics and in the following order (note only those top level topics in which the current reference has an applciable category need appear), i.e.:
'''Enter the reference in the selected category page''' in alphabetical order by the [first] author's last name.
 
Categories should be separated by top level Table of Contents topics and in the following order (note only those top level topics in which the current reference has an applicable category need appear), i.e.:


* Overview:
* Overview:
Line 60: Line 75:
* Approaches:  
* Approaches:  


b) Categories within a single top level Table of Contents topic should be separated by semicolons and arranged in alphabetical order, i.e.
Multiple categories within a single top level Table of Contents topic should be separated by semicolons and arranged in alphabetical order, i.e.


* Threats and Actors: [[The Threat and Skeptics]]; [[States]]; [[Security Targets]]
* Threats and Actors: [[The Threat and Skeptics]]; [[States]]; [[Security Targets]]


c) Categories refer to the major themes of the reference.  If the reference only mentions a category in passing but does not focus on it, then it need not be included.
==== 4.4 Key Words ====
'''Add Relevant Keywords:''' Add Glossary/Keyword entries in alphabetical order separated by commas.  You can copy links from the [[List of Keyword links to copy into reference pages | Keyword Links]] page directly into the reference page.  (Switch to "edit" mode to copy the link -- be careful not to change the text on the Keyword Links page though.)


9) Add Glossary, Keyword entries in alphabetical order separated by commas.  You can copy links from the [[List of Keyword links to copy into reference pages | Keyword Links]] page directly into the reference page.  Make sure to create kinks from the [[Keyword Index and Glossary of Core Ideas]] page back to the reference.  If another reference by the same author
'''In the glossary, create links back to the reference page:''' Make sure to create links from the [[Keyword Index and Glossary of Core Ideas]] page back to the reference.  If another reference by the same author is linked under a given keyword, use "[2]", "[3]", etc. for succeeding entries.
is linked under a given keyword, use [2], [3], etc. for succeeding entries.


a) Links to Keywords are appropriate even when the item is only mentioned in passing in the reference.  The purpose of keywords are to help someone unfamiliar with the term or  
'''New keywords:''' If you decide to add a new keyword to the [[Keyword Index and Glossary of Core Ideas]], make sure to update the [[List of Keyword links to copy into reference pages | Keyword Links]] page.  It is also a good idea to email either David Abrams or Caroline Nolan of the addition.
 
Note that links to Keywords are appropriate ''even when the item is only mentioned in passing in the reference''.  The purpose of keywords are to help someone unfamiliar with the term or  
to provide a way to find other references with the same keyword but appearing in a separate category.
to provide a way to find other references with the same keyword but appearing in a separate category.


b) If you need to add a new keyword to the [[Keyword Index and Glossary of Core Ideas]], make sure to update the [[List of Keyword links to copy into reference pages | Keyword Links]] page.  It is also a good idea to email either David Abrams or Caroline Nolan of the addition.
====4.5 Synopsis====
'''Add the Synopsis:'''  The goal is not merely to summarize the subject matter of the reference; rather, the synopsis should also summarize the author's conclusions as well.  Typically this will be equivalent to an executive summary, and that section of the reference, if available, can provide the basis of the synopsis.  Alternately, quoted opening or conclusion paragraphs from the reference may form the basis for the synopsis.  Feel free to use wiki section headings "===", "====", etc. to provide clarity to the synopsis.


10) Add the Synopsis. The goal is not merely to summarize the subject matter of the reference; rather, the synopsis should also summarize the author's conclusions as well.  Typically this will be equivalent to an executive summary, and that section of the reference, if available, can provide the basis of the synopsis.  Alternately, quoted opening or conclusion paragraphs from the reference may form the basis for the synopsis.  Feel free to use wiki section headings "===", "====", etc. to provide clarity to the synopsis.
====4.6 Additional Notes and Highlights====
Finally, the "Additional Notes and Highlights" section provides a place to include information that does not fit in elsewhere.


11) Finally, the Additional Notes and Highlights section provides a place to include information that does not fit in elsewhere.
'''Required:''' This section should begin with "Expertise Required: " followed by either "None" or one or more "<field> - <level>" pair separated by semicolons.  Level is one of "Low", "Moderate" or "High" (although intermediate values "Low/Moderate" are allowed.  If there are multiple field/level pairs, order them from highest expertise level to lowest, e.g.,


a) This section should begin with "Expertise Required: " followed by either "None" or one or more "<field> - <level>" pair separated by semicolons.  Level is one of "Low", "Moderate" or "High" (although intermediate values "Low/Moderate" are allowed.  If there are multiple field/level pairs, order them from highest level to lowest, e.g.,
Expertise Required: Economics - Moderate; Law - Low


Expertise Required: Economics - Moderate; Law - Low
This is a subjective measure.  "None" means a person with a college education but no specific expertise in the subject matter of the reference would be able to understand it.  "High" suggests that a great deal of knowledge in the subject matter is required, possibly because of extensive mathematical equations or jargon-filled discussion.
 
(Note that on the reference page, each expertise entry is ordered with subject matter first followed by level required; however, in the TOC, the highest level of competence is always placed first to allow the user to sort on that parameter.)


This is a subjective measure.  "None" means a person with a college education but no specific expertise in the subject matter of the reference would be able to understand it.  "High" suggests that a great deal of knowledge in the subject matter is required, possibly because of extensive mathematical equations or jargon filled discussion.
'''Other possible items to include in the Additional Notes and Highlights (if available) are:'''


(Note that in the reference, the expertise section consists of subject matter first followed by level required while in the TOC tables, the highest level of competence is always first to allow the user to sort on that parameter.)
* The '''table of contents''' of the reference: [[Overcoming Impediments to Information Sharing#Additional Notes and Highlights]].


b) Other possible items to include in the Additional Notes and Highlights if available are:
* '''Biographic information''' about the author: [[Armed Attack in Cyberspace#Additional Notes and Highlights]] or about an organization [[Security Economics and the Internal Market#Additional Notes and Highlights]].


i) The table of contents of the reference: [[Overcoming Impediments to Information Sharing#Additional Notes and Highlights]].
* '''Reviews''' of the reference: [[Do Data Breach Disclosure Laws Reduce Identity Theft#Additional Notes and Highlights]].


ii) Biographic information about the author: [[Armed Attack in Cyberspace#Additional Notes and Highlights]] or about an organization [[Security Economics and the Internal Market#Additional Notes and Highlights]].
* '''Excerpts''' or chapters where the full reference is not available online: [[Cyber War#Additional Notes and Highlights]].


iii) Reviews of the reference: [[Do Data Breach Disclosure Laws Reduce Identity Theft#Additional Notes and Highlights]].
* Links to '''the author's home page''': [[Why Information Security is Hard#Additional Notes and Highlights]].


iv) Excerpts or chapters where the full reference is not available online: [[Cyber War#Additional Notes and Highlights]].
* "See also" information that would be useful to the reader: [[Law and War in the Virtual Era#Additional Notes and Highlights]].


v) Links to the author's home page: [[Why Information Security is Hard#Additional Notes and Highlights]].
* Information on (and possibly links to) '''previous versions''' of the reference: [[A Roadmap for Cybersecurity Research#Additional Notes and Highlights]].


vi) "See also" information that would be useful to the reader: [[Law and War in the Virtual Era#Additional Notes and Highlights]].
* Description of a '''useful appendix or glossary''' in the reference: [[Critical Infrastructure Threats and Terrorism#Additional Notes and Highlights]].


vii) Information on (and possibly links to) previous versions of the reference: [[A Roadmap for Cybersecurity Research#Additional Notes and Highlights]].
===5. Check your Work===


12) Make sure to enter the reference in the [[Cybersecurity Annotated Bibliography]] list of all reference in the wiki.
* Check all your links to make sure they work.
* Make sure that your reference is included in the [[Cybersecurity Annotated Bibliography]] list of all reference in the wiki.
* Make sure the reference appears in the selected categories and ''all the higher level categories'' of the selected categories.
* Make sure your category links not only work but properly link back to the reference.
* Make sure your keywords links not only work but properly link back to the reference.-->

Latest revision as of 16:30, 9 August 2012

This page is undergoing revision, thank you for your patience.


Retrieved from "http://cyber.harvard.edu/cybersecurity/?title=Adding_a_Reference&oldid=6838"