OATP conventions - Revision history

Petersuber: Replaced content with "This page [http://cyber.law.harvard.edu/hoap/OATP_conventions moved] on May 24, 2015. Please update your bookmarks."

2015-05-24T13:47:05Z

Replaced content with "This page [http://cyber.law.harvard.edu/hoap/OATP_conventions moved] on May 24, 2015. Please update your bookmarks."

Show changes

Petersuber: /* Use of English */

2015-04-19T18:42:30Z

Use of English

← Older revision		Revision as of 14:42, 19 April 2015
Line 66:		Line 66:
	** If the tagged work is not in English, then the description could be the tagger's English-language summary or paraphrase, the tagger's English translation of an excerpt, or a machine translation of an excerpt.		** If the tagged work is not in English, then the description could be the tagger's English-language summary or paraphrase, the tagger's English translation of an excerpt, or a machine translation of an excerpt.
	** If you use a machine translator like Google Translate to generate an English translation of a non-English excerpt, then put the excerpt in quotation marks and precede it with a line to this effect: "From Google's English: " We don't want readers to blame authors for the clumsy language in machine translations.		** If you use a machine translator like Google Translate to generate an English translation of a non-English excerpt, then put the excerpt in quotation marks and precede it with a line to this effect: "From Google's English: " We don't want readers to blame authors for the clumsy language in machine translations.

			* Titles should remain in their original language.
			** If you want to include an English translation of the title, put it in the description field.

	* The URL in the tag record should be the original URL, not the URL of a machine translation.		* The URL in the tag record should be the original URL, not the URL of a machine translation.
	** If your method of reaching a machine translation changes the URL, then ~~open~~ the ~~tagging bookmarklet first~~. ~~That will put~~ the original ~~URL into~~ the ~~tag record~~. ~~Then go to~~ the machine translation in order to decide what tags to apply and what description to use.		** If your method of reaching a machine translation changes the URL, then don't tag the machine-translation page. Return to the original page to tag it (to call up the tagging bookmarklet). But by all means use the machine-translation page in order to decide what tags to apply and what description to use.
	** If you forget this step and notice that the URL used in the bookmarklet is the URL of a machine translation, then manually replace it with the original URL before adding the item to TagTeam.		** If you forget this step and notice that the URL used in the bookmarklet is the URL of a machine translation, then manually replace it with the original URL before adding the item to TagTeam.

	* User-defined tags need not be in English.		* User-defined tags need not be in English.
	** Example: If an article is about OA books, then tag it with English tag ''oa.books'', but feel free to add an equivalent non-English tag as well, such as ''oa.libros'', ''oa.livres'', or ''oa.buecher''.		** Example: If an article is about OA books, then tag it with English tag ''oa.books'', but feel free to add an equivalent non-English tag as well, such as ''oa.libros'', ''oa.livres'', or ''oa.buecher''.

	* Titles need not be in English. The title of the work you're tagging should remain in its original language.

	* When the tagged item is not in English, always use a tag for the original language (e.g. ''oa.arabic'', ''oa.bulgarian'', ''oa.chinese''). If the item is not in English and is about OA in a particular country, then use both a language tag and a country tag (e.g. ''oa.french'' and ''oa.france'').		* When the tagged item is not in English, always use a tag for the original language (e.g. ''oa.arabic'', ''oa.bulgarian'', ''oa.chinese''). If the item is not in English and is about OA in a particular country, then use both a language tag and a country tag (e.g. ''oa.french'' and ''oa.france'').

Petersuber: /* Use of English */

2015-04-19T18:36:36Z

Use of English

← Older revision		Revision as of 14:36, 19 April 2015
Line 66:		Line 66:
	** If the tagged work is not in English, then the description could be the tagger's English-language summary or paraphrase, the tagger's English translation of an excerpt, or a machine translation of an excerpt.		** If the tagged work is not in English, then the description could be the tagger's English-language summary or paraphrase, the tagger's English translation of an excerpt, or a machine translation of an excerpt.
	** If you use a machine translator like Google Translate to generate an English translation of a non-English excerpt, then put the excerpt in quotation marks and precede it with a line to this effect: "From Google's English: " We don't want readers to blame authors for the clumsy language in machine translations.		** If you use a machine translator like Google Translate to generate an English translation of a non-English excerpt, then put the excerpt in quotation marks and precede it with a line to this effect: "From Google's English: " We don't want readers to blame authors for the clumsy language in machine translations.

			* The URL in the tag record should be the original URL, not the URL of a machine translation.
			** If your method of reaching a machine translation changes the URL, then open the tagging bookmarklet first. That will put the original URL into the tag record. Then go to the machine translation in order to decide what tags to apply and what description to use.
			** If you forget this step and notice that the URL used in the bookmarklet is the URL of a machine translation, then manually replace it with the original URL before adding the item to TagTeam.

	* User-defined tags need not be in English.		* User-defined tags need not be in English.

Petersuber: /* Tagging soon */

2015-04-10T18:11:18Z

Tagging soon

← Older revision		Revision as of 14:11, 10 April 2015
Line 119:		Line 119:
	=== Tagging soon ===		=== Tagging soon ===

	* One mission of OATP is to provide real-time alerts about what's new in the world of OA. When you see a relevant item, please try to tag it quickly. Ideally, all new developments ~~will be tagged~~ within hours of their first appearance online.		* One mission of OATP is to provide real-time alerts about what's new in the world of OA. When you see a relevant item, please try to tag it quickly. Ideally, we'll tag all new developments within hours of their first appearance online.

	=== Pacing yourself ===		=== Pacing yourself ===

Petersuber: /* Taggable items */

2015-04-10T18:02:35Z

Taggable items

← Older revision		Revision as of 14:02, 10 April 2015
Line 151:		Line 151:
	== Taggable items ==		== Taggable items ==

			=== On-topic v. off-topic items ===

	~~=== On-topic v. off-topic items ===~~
	* OATP focuses on ''open access to research''. Tag anything directly related to that topic.		* OATP focuses on ''open access to research''. Tag anything directly related to that topic.

Line 181:		Line 181:
	** If you make a tag retroactively comprehensive, please let us know and we will annotate the tag accordingly.		** If you make a tag retroactively comprehensive, please let us know and we will annotate the tag accordingly.
	** When a tag is retroactively comprehensive, users will have more confidence in using that tag to include or exclude items from searches.		** When a tag is retroactively comprehensive, users will have more confidence in using that tag to include or exclude items from searches.

	~~=== Online v. offline items ===~~

	* We can only tag online pages, not print works or offline digital files.

	* If you find a relevant work in print, look for an online edition to tag. If need be, tag an online metadata record, announcement, review, or advertisement, anything online to get the work, or some notice of the work, into the OATP feed and database.

	* If you click on a link to an item, and a PDF downloads to your hard drive, rather than displaying in your browser, then look for an online splash page (aka landing page) for the same work.

	=== Best sources v. other sources ===		=== Best sources v. other sources ===
Line 209:		Line 201:

	* Note that the ''oa.mobile'' tag is for OA-related developments for mobile devices, whether or not the pages describing those developments are displayed in mobile format.		* Note that the ''oa.mobile'' tag is for OA-related developments for mobile devices, whether or not the pages describing those developments are displayed in mobile format.

			=== Online v. offline items ===

			* We can only tag online pages, not print works or offline digital files.

			* If you find a relevant work in print, look for an online edition to tag. If need be, tag an online metadata record, announcement, review, or advertisement, anything online to get the work, or some notice of the work, into the OATP feed and database.

			* If you click on a link to an item, and a PDF downloads to your hard drive, rather than displaying in your browser, then look for an online splash page (a.k.a. landing page) for the same work.

	=== Adding original content ===		=== Adding original content ===

Petersuber: /* Tagging guidelines */

2015-04-10T17:58:06Z

Tagging guidelines

Petersuber: /* Items you may omit */

2015-04-02T15:09:42Z

Items you may omit

← Older revision		Revision as of 11:09, 2 April 2015
Line 216:		Line 216:
	=== Items you may omit ===		=== Items you may omit ===

	Of course you may omit anything you like! Participation in OATP is entirely voluntary and we wouldn't want it any other way. But if you want to capture all the OA-related developments you see, or ~~all those~~ from a certain country ~~or on a certain subtopic~~, there are still some items you should feel free to omit.		Of course you may omit anything you like! Participation in OATP is entirely voluntary and we wouldn't want it any other way. But if you want to capture all the OA-related developments you see on a certain subtopic, in a certain field, or from a certain country, there are still some items you should feel free to omit.

	* Feel free to omit very short items like tweets, listserv messages, and comments on blog posts.		* Feel free to omit very short items like tweets, listserv messages, and comments on blog posts.

Petersuber: /* Items you may omit */

2015-04-02T13:07:54Z

Items you may omit

← Older revision		Revision as of 09:07, 2 April 2015
Line 229:		Line 229:

	* Omit reprints or repostings of relevant articles published elsewhere. In cases like this, try to tag the primary source instead of the reprint. If the primary source is online, tag it. If it's not OA and you can find an OA edition, then also tag an OA edition. But if you keep finding new OA editions, you needn't and shouldn't tag them all.		* Omit reprints or repostings of relevant articles published elsewhere. In cases like this, try to tag the primary source instead of the reprint. If the primary source is online, tag it. If it's not OA and you can find an OA edition, then also tag an OA edition. But if you keep finding new OA editions, you needn't and shouldn't tag them all.

			* Omit offers of temporary OA, preview OA, or teaser OA. That is not OA in the sense covered by OATP.

	* Feel free to omit items based on deep misunderstanding, whether innocent or cynical. This is a hard call, because we want to include even articles that are highly critical of OA (with tag ''oa.negative''). But one purpose of the OATP is to raise the level of understanding of OA, and we undermine this purpose when we raise the visibility of distortion and deception. At the same time, however, feel free to tag such items in the spirit of documenting the distortion and deception still in circulation.		* Feel free to omit items based on deep misunderstanding, whether innocent or cynical. This is a hard call, because we want to include even articles that are highly critical of OA (with tag ''oa.negative''). But one purpose of the OATP is to raise the level of understanding of OA, and we undermine this purpose when we raise the visibility of distortion and deception. At the same time, however, feel free to tag such items in the spirit of documenting the distortion and deception still in circulation.

Pagea: /* Titles */

2015-04-01T17:53:39Z

Titles

← Older revision		Revision as of 13:53, 1 April 2015
Line 57:		Line 57:
	=== Titles ===		=== Titles ===

	* Make sure the item's title is correct in the tag record. Sometimes the TagTeam bookmarklet grabs the title of the periodical rather than the title of the article, or the title of the blog rather than the title of the blog post. Sometimes it truncates the title. Sometimes it leaves the title field blank. When the TagTeam bookmarklet form is open for you to fill out, you can see its proposal for the item title and edit it for correctness		* Make sure the item's title is correct in the tag record. Sometimes the TagTeam bookmarklet grabs the title of the periodical rather than the title of the article, or the title of the blog rather than the title of the blog post. Sometimes it truncates the title. Sometimes it leaves the title field blank. When the TagTeam bookmarklet form is open for you to fill out, you can see its proposal for the item title and edit it for correctness.

	=== Use of English ===		=== Use of English ===

Petersuber: /* Tag convergence */

2015-03-31T16:33:35Z

Tag convergence

← Older revision		Revision as of 12:33, 31 March 2015
Line 272:		Line 272:

	* OATP started as an informal folksonomy but is evolving toward a more formal ontology. One way we are doing this is through the power of [[What is TagTeam?\|TagTeam]] to convert deprecated tags to [[OATP tags\|approved tags]] automatically.		* OATP started as an informal folksonomy but is evolving toward a more formal ontology. One way we are doing this is through the power of [[What is TagTeam?\|TagTeam]] to convert deprecated tags to [[OATP tags\|approved tags]] automatically.
	** Note that this process only affects the TagTeam copies of tag records, for example, for publishing output feeds and searching. If you tagged items on another platform (such as CiteULike or Delicious), and TagTeam ~~subscribed~~ to your feeds from that platform, then the TagTeam filters will only modify the TagTeam copies of your tags, not your original tags on the original platform.		** Note that this process only affects the TagTeam copies of tag records, for example, for publishing output feeds and searching. If you tagged items on another platform (such as CiteULike or Delicious), and asked TagTeam to subscribe to your feeds from that platform, then the TagTeam filters will only modify the TagTeam copies of your tags, not your original tags on the original platform.

	* As the project decides on the best tags to use for certain subtopics, we record them on the page of [[OATP tags\|project tags]]. Please follow the usage on that page.		* As the project decides on the best tags to use for certain subtopics, we record them on the page of [[OATP tags\|project tags]]. Please follow the usage on that page.

← Older revision		Revision as of 13:58, 10 April 2015
Line 19:		Line 19:
	* OATP has only one primary tag, ''oa.new''. Use this tag for OA developments that are new within the last six months, at the time of tagging. Also use it for new articles and comments about older developments.		* OATP has only one primary tag, ''oa.new''. Use this tag for OA developments that are new within the last six months, at the time of tagging. Also use it for new articles and comments about older developments.

	* Secondary tags cover OA subtopics, such as OA in a certain field, OA in a certain language, OA in a certain country, or ~~certain~~ aspects of OA itself, such as OA through repositories, OA through journals, OA and copyright, OA business models, and so on.		* Secondary tags cover OA subtopics, such as OA in a certain field, OA in a certain language, OA in a certain country, or different aspects of OA itself, such as OA through repositories, OA through journals, OA and copyright, OA business models, and so on.

	* Always use the primary tag ''oa.new'' for new items and always omit it for older items.		* Always use the primary tag ''oa.new'' for new items and always omit it for older items.
Line 35:		Line 35:
	** Example: Because we already have an approved tag, ''oa.people'', there's no need to create a new tag for the same subtopic, like ''oa.personnel''.		** Example: Because we already have an approved tag, ''oa.people'', there's no need to create a new tag for the same subtopic, like ''oa.personnel''.

	* If you don't have time to check to see whether OATP already has an approved tag for a given topic, just ~~use~~ a tag that makes sense to you. With TagTeam, OATP project managers can automatically convert synonymous tags to the same tag, or deprecated tags to approved tags. For example, TagTeam automatically converts ''oa.monographs'' and ''oa.ebooks'' to ''oa.books''.		* If you don't have time to check to see whether OATP already has an approved tag for a given topic, just invent a tag that makes sense to you. With TagTeam, OATP project managers can automatically convert synonymous tags to the same tag, or deprecated tags to approved tags. For example, TagTeam automatically converts ''oa.monographs'' and ''oa.ebooks'' to ''oa.books''.

	* When you invent tags, please follow the OATP conventions for [[#Tag syntax\|tag syntax]], below.		* When you invent tags, please follow the OATP conventions for [[#Tag syntax\|tag syntax]], below.
Line 45:		Line 45:
	* If the piece has an abstract, just enter "Abstract: " and then cut/paste all or part of the abstract.		* If the piece has an abstract, just enter "Abstract: " and then cut/paste all or part of the abstract.

	* If the piece doesn't have an abstract, then quote or paraphrase an OA-relevant passage. Your description will help OATP readers decide whether to click through to the full text. It will help them skim and learn about new developments without clicking through. It will be searchable in TagTeam (along with your tags) and help users find items on certain topics. The better ~~the description~~ or quoted passages, the better we help users.		* If the piece doesn't have an abstract, then quote or paraphrase an OA-relevant passage. Your description will help OATP readers decide whether to click through to the full text. It will help them skim and learn about new developments without clicking through. It will be searchable in TagTeam (along with your tags) and help users find items on certain topics. The better your descriptions or quoted passages, the better we help users.

	* If you use a quotation, please put it in quotation marks.		* If you use a quotation, please put it in quotation marks.
Line 53:		Line 53:
	* If your quoted description contains an acronym that many readers may not understand, spell it out in square brackets.		* If your quoted description contains an acronym that many readers may not understand, spell it out in square brackets.

	* When the original file does not support cutting and pasting (e.g. a locked PDF, an image-scan, a slide presentation, a video), then either re-key an excerpt or compose your own summary or description.		* When the original file does not support cutting and pasting (e.g. a locked PDF, an image-scan, a slide presentation, a video), then either re-key an excerpt or compose your own summary, paraphrase, or description.

	=== Titles ===		=== Titles ===
Line 64:		Line 64:

	* All [[#Descriptions\|descriptions]] should be in English.		* All [[#Descriptions\|descriptions]] should be in English.
	** If the tagged work is not in English, then the description ~~should~~ be the tagger's English-language summary or paraphrase, the tagger's English translation of an excerpt, or a machine translation of an excerpt.		** If the tagged work is not in English, then the description could be the tagger's English-language summary or paraphrase, the tagger's English translation of an excerpt, or a machine translation of an excerpt.
	** If you use a machine translator like Google Translate to generate an English translation of a non-English excerpt, then put the excerpt in quotation marks and precede it with a line to this effect: "From Google's English: " We don't want readers to blame ~~the author~~ for the clumsy language ~~of a~~ machine ~~translation~~.		** If you use a machine translator like Google Translate to generate an English translation of a non-English excerpt, then put the excerpt in quotation marks and precede it with a line to this effect: "From Google's English: " We don't want readers to blame authors for the clumsy language in machine translations.

	* User-defined tags need not be in English.		* User-defined tags need not be in English.