OATP tips - Revision history

Petersuber at 13:41, 24 May 2015

2015-05-24T13:41:07Z

← Older revision		Revision as of 09:41, 24 May 2015
Line 1:		Line 1:
	~~#REDIRECT~~ [http://cyber.law.harvard.edu/hoap/OATP_tips]		This page [http://cyber.law.harvard.edu/hoap/OATP_tips moved] on May 24, 2015. Please update your bookmarks.

Petersuber at 13:40, 24 May 2015

2015-05-24T13:40:24Z

← Older revision		Revision as of 09:40, 24 May 2015
Line 1:		Line 1:
	#REDIRECT [~~http://cyber.law.harvard.edu/hoap/OATP_tips~~ http://cyber.law.harvard.edu/hoap/OATP_tips]		#REDIRECT [http://cyber.law.harvard.edu/hoap/OATP_tips]

Petersuber: Replaced content with "#REDIRECT [http://cyber.law.harvard.edu/hoap/OATP_tips http://cyber.law.harvard.edu/hoap/OATP_tips]"

2015-05-24T13:39:43Z

Replaced content with "#REDIRECT [http://cyber.law.harvard.edu/hoap/OATP_tips http://cyber.law.harvard.edu/hoap/OATP_tips]"

← Older revision		Revision as of 09:39, 24 May 2015
Line 1:		Line 1:
	<!-- /////////////// I emptied out nearly all of this page March 23, 2015, and moved its contents to the page on OATP conventions. Since then, I also removed the page from the OATP front page or TOC. //////////////////// -->		#REDIRECT [http://cyber.law.harvard.edu/hoap/OATP_tips http://cyber.law.harvard.edu/hoap/OATP_tips]
	~~[[File:oad2.jpeg\|60px]] This list is part of the [http://oad.simmons.edu Open Access Directory].~~

	~~{\| align="right"~~
	~~\| __TOC__~~
	\|}

	~~<!-- <center>~~
	~~{\| class="wikitable" style="text-align:center" border="0" cellpadding="8" cellspacing="0"~~
	~~\| style="background:lightgray; color:black" \|   This page has '''not''' yet been updated to reflect the transition from Connotea to TagTeam. it will be soon  ~~
	\|}
	~~</center>~~
	~~-->~~
	* This is a section within the larger [[OA tracking project]] (OATP).

	* Project ''tips'' are suggestions on how to help or be helped by the project. For more settled decisions and agreements on how to carry out the project, see the page on project [[OATP conventions \| conventions]].

	~~[[Category:Research about OA]] [[Category:Working for OA]]~~

	~~== Tips for readers ==~~

	* '''Reading full text'''
	** An OATP feed consists of tag records, which contain brief summaries or descriptions, with links to full texts. They do not contains full texts themselves. For some purposes, this austerity is an advantage: OATP tag records are easier to read or skim than an equal number of full texts. But for other purposes, it's a disadvantage: they contain less information than full texts.
	** If you want to skip the austere tag records and jump straight to the tagged texts themselves, then subscribe to the project feed with Google Reader. Put the "Next" bookmarklet in your browser toolbar. Clicking on it will take you to the next item in the feed --not the next austere tag record but the full-text item tagged by the next tag record.
	*** Clearly this recommendation has been obsolete since Google pulled the plug on Reader in July 2014. If you know other tools with the same feature described here, please let us know.

	* '''Searching'''
	** You can search the whole corpus of OATP tag records inside [http://tagteam.harvard.edu/ TagTeam]. You needn't be a registered TagTeam user to do so.
	*** For details on the flexibility of the TagTEam search engine, see the [http://cyber.law.harvard.edu/hoap/~~TagTeam_basics#Searching section on searching] in the [~~http://cyber.law.harvard.edu/hoap/~~TagTeam_basics TagTeam manual].~~
	** If you subscribe to an OATP feed with Google Reader, then you can take advantage of its Google-based searching of the feed all the way back to the feed's beginning, even if you didn't start subscribing until some later date.
	*** Again, this powerful Google Reader feature is no longer available, and we welcome suggestions for other tools with the same feature.

	~~== Tips for taggers ==~~

	* All the items in this section have been moved to the section of tagging guidelines on our page of [[OATP conventions]].

	~~== Tips for others ==~~

	* '''If you have a blog''':
	** Put a [http://oad.simmons.edu/oadwiki/OATP_mashups#Widgets_to_display_the_feed widget] in the sidebar to display the most recent items from the project feed.

	* '''If you maintain a web page that links to an OATP tag library''':
	** Make sure that the entry for that tag on the [[OATP tags\| tags page]] mentions your link to the tag library. This not only gives you more exposure, but shows how people are using the OATP links.
	** Check the [[OATP tags]~~] page periodically to see whether the tag has been deprecated and replaced with another. If it has, then you should link to the library for the new and preferred tag.~~
	<!-- ** Some OATP tags are not about to change, such as [http://www.connotea.org/tag/oa.new oa.new] and [http://www.connotea.org/tag/oa.france oa.france]. But others are in flux and may change. For example, since its launch OATP has shifted from singular to plural nouns, deprecating ''oa.repository'' in favor of ''oa.repositories'', and has shifted in the way it treated phrases with spaces, deprecating ''oa.saudiarabia'' in favor of ''oa.saudi_arabia''. -->

	* '''If you want to link to OATP output''':
	** To link to the primary project feed (HTML edition): <code><nowiki>http://tagteam.harvard.edu/remix/oatp</nowiki></code> .
	** To link to the tag library for a given ''tag'': <code><nowiki>http://tagteam.harvard.edu/hubs/3/tag/TAG</nowiki></code> . For example: <code><nowiki>http://tagteam.harvard.edu/hubs/3/tag/oa.policies</nowiki></code> .
	~~<!-- restore these when TagTeam supports these kinds of links~~
	** To link to the tag library of a given ''tagger'': <code><nowiki>http://www.connotea.org/user/TAGGER</nowiki></code> . For example: <code><nowiki>http://www.connotea.org/user/petersuber</nowiki></code> .
	** To link to the tag library of a given ''tagger'' for a given ''tag'': <code><nowiki>http://www.connotea.org/user/TAGGER/tag/TAG</nowiki></code> . For example: <code><nowiki>http://www.connotea.org/user/petersuber/tag/oa.new</nowiki></code> . -->
	<!-- ** To link to an individual ''tag record'': First go to the ''oa.new'' tag library, [http://www.connotea.org/tag/oa.new oa.new] (or any other relevant tag library). Scroll or search until you find the tag record to which you want to link. The URL you want is under the word "info". For example: <code><nowiki>http://www.connotea.org/article/fe5f4475e5b415ecd81a9732da2b854a</nowiki></code> . -->

Petersuber at 14:39, 23 March 2015

2015-03-23T14:39:55Z

← Older revision		Revision as of 10:39, 23 March 2015
Line 1:		Line 1:
			<!-- /////////////// I emptied out nearly all of this page March 23, 2015, and moved its contents to the page on OATP conventions. Since then, I also removed the page from the OATP front page or TOC. //////////////////// -->
	[[File:oad2.jpeg\|60px]] This list is part of the [http://oad.simmons.edu Open Access Directory].		[[File:oad2.jpeg\|60px]] This list is part of the [http://oad.simmons.edu Open Access Directory].

Petersuber: /* Tips for taggers */

2015-03-23T14:26:49Z

Tips for taggers

@@ Line 32: / Line 32: @@
 == Tips for taggers ==
-* '''Tagging items that may soon disappear'''
+* All the items in this section have been moved to the section of tagging guidelines on our page of [[OATP conventions]].
 == Tips for others ==

Petersuber: /* Tips for taggers */

2015-03-23T14:22:12Z

Tips for taggers

← Older revision		Revision as of 10:22, 23 March 2015
Line 31:		Line 31:

	== Tips for taggers ==		== Tips for taggers ==





	* '''Tagging events'''
	** If you tag a conference or workshop, before or after it occurs, take a moment to see whether it's listed on the OAD [[Events]] page. If not, please add it.
	** People looking for events in their area (to see what they could attend), or at a given future time (to avoid conflicts for their own future events), consult the OAD Events list more often than the any OA-related feed. Hence, if you had to choose, it's more helpful to post upcoming events to the OAD list than to tag them for OATP. But unless you're very short on time, you don't have to choose and can do both.

	* '''Tagging items that may soon disappear'''		* '''Tagging items that may soon disappear'''

Petersuber: /* Tips for taggers */

2015-03-23T14:20:36Z

Tips for taggers

← Older revision		Revision as of 10:20, 23 March 2015
Line 33:		Line 33:


	* '''Fixing parsing errors'''
	** Your tagging platform will usually try to extract the title of the item you're tagging. But sometimes it will leave the title field blank. Sometimes it mistake the title of a journal for the title of a journal article, or mistake the title of a blog for the title of a blog post. In those cases, just type or cut/paste the proper title into the "title" field of the dialog box.

	* '''Avoiding deprecated tags'''
	** As the project evolves, it upgrades some user-defined tags to approved or official project tags, and downgrades others to deprecated tags. For example, ''oa.ebooks'' is now deprecated in favor of ''oa.books''. The page of [[OATP tags\|project tags]] lists the approved project tags and indicates the deprecated tags (if any) they replace.
	** One tip for taggers is to use accepted tags rather than deprecated tags. In one sense, that tip is hardly necessary, since OATP uses the power of [[What is TagTeam?\|TagTeam]] to convert deprecated tags to approved tags automatically. On the other hand, if you tag for OATP, then you should know that this process is taking place. If you use deprecated tags in TagTeam itself, they will be changed. If you use them in another platform, they will remain unaffected but the TagTeam copies will be changed.

	* '''Adding original content'''
	** To insert an original piece of news or comment into the project feed, and make it available in OATP searches, first put it online in a way that gives it a unique URL (blog post, discussion forum contribution, wiki section, standalone web page). Then tag the online version.

	* '''Tagging events'''		* '''Tagging events'''

Petersuber: /* Tips for taggers */

2015-03-23T14:11:31Z

Tips for taggers

← Older revision		Revision as of 10:11, 23 March 2015
Line 32:		Line 32:
	== Tips for taggers ==		== Tips for taggers ==

	* '''Adding subtopic tags'''
	** If you see a new item related to OA, and time is very tight, tag it with ''oa.new'' and be on your way. However, we strongly encourage taggers to add relevant [[OATP tags\|subtopic tags]] at the same time, such as ''oa.policies'', ''oa.biology'', ''oa.brazil'', and ''oa.portuguese''.
	** The use of subtopic tags greatly helps users who want to subscribe to specialized feeds or run effective searches on the OATP database in TagTeam.

	* '''Adding descriptions'''
	** If your tagging platform allows you to add descriptions along with your tags, please add a brief excerpt or summary.
	** For a journal article with an abstract, paste in the whole abstract or key excerpts from the abstract.
	** Descriptions should be in English. When you tag an item not written in English, you can write in your own English translation of key excerpts, write in your own English-language summary or paraphrase, or cut/paste an excerpt from a machine translation service.
	** If your tagging platform distinguishes descriptions from comments (like Connotea, for example), then descriptions will appear in the TagTeam feeds and searches, but comments will not.

	* '''Retroactive tagging'''
	** Remember that OATP was launched in April 2009. While the project encourages retroactive tagging, little has been done so far. Make it a habit to tag older items as you encounter them. Use any relevant subtopic tags, but do not use ''oa.new''.
	** If you're doing a research project on OA, make a point of tagging all the OA-related literature you find online with relevant OATP subtopic tags. That will help you do your research and help other OATP users searching for work on the same subtopics.
	** If you systematically search for online articles on a certain subtopic of OA, and tag them with the relevant tag, then go to the OATP [[OATP tags\|tags page]] and annotate that tag as "Retroactively comprehensive since about (date)." That will give users more confidence when using that tag to include or exclude items from searches.
	~~<!-- commented out because less relevant after TagTeam~~
	* '''Retroactive tag revision'''
	** Many tagging platforms allow you to revise your tags retroactively. If you want to change all your own occurrences of ''oa.journal'' to ''oa.journals'', just load your personal tag library and look for "Rename a tag" in the right-hand sidebar.
	** Periodically inspect your personal tag library and scan the list of tags you've used. If you see any that are misspelled or deprecated, use the "Rename a tag" command to change them retroactively.
	~~-->~~

	* '''Fixing parsing errors'''		* '''Fixing parsing errors'''

Petersuber: /* Tips for readers */

2015-03-23T14:10:26Z

Tips for readers

← Older revision		Revision as of 10:10, 23 March 2015
Line 18:		Line 18:

	== Tips for readers ==		== Tips for readers ==

	~~<!-- this tip may be unnecessary in the TagTeam version; in any case, old link needs updating~~
	* '''Avoiding gaps in coverage'''
	** If you subscribe to a feed by RSS or email, don't use a version that only shows the 10 most recent items. If there are more than 10 new items before the feed refreshes, you'll miss some of them. For other options, see [http://oad.simmons.edu/oadwiki/OATP_links#Versions_of_the_project_feed Versions of the project feed].
	~~-->~~
	~~<!--~~
	* To read a version of the project feed that filters out duplicates, see [[OATP mashups]].
	** But be careful. Often the first person to tag an item will use ''oa.new'' and omit subtopic tags. The next users to see the item might tag it with ''oa.new'' and subtopic tags. If so, you'll see the first tag record only and fail the benefit from the subtopic tags added by subsequent users. Among other things, seeing the subtopic tags applied by others can help you decide whether to click through to read the full text.
	** We're trying to get Connotea to show users a consolidated tag record, but this feature may not appear any time soon.
	~~-->~~

	* '''Reading full text'''		* '''Reading full text'''
	** An OATP feed consists of tag records, which ~~are more austere than articles~~ or ~~blog posts~~. For some purposes, ~~these brief records are~~ an advantage: ~~they're~~ easier to read or skim than an equal number of ~~blog posts or articles~~. But for other purposes, ~~they~~'re a disadvantage: they contain less information than ~~blog posts or articles~~.		** An OATP feed consists of tag records, which contain brief summaries or descriptions, with links to full texts. They do not contains full texts themselves. For some purposes, this austerity is an advantage: OATP tag records are easier to read or skim than an equal number of full texts. But for other purposes, it's a disadvantage: they contain less information than full texts.
	** If you want to skip the austere tag records and jump straight to the tagged texts themselves, then subscribe to the project feed with Google Reader. Put the "Next" bookmarklet in your browser toolbar. Clicking on it will take you to the next item in the feed --not the next austere tag record but the full-text item tagged by the next tag record.		** If you want to skip the austere tag records and jump straight to the tagged texts themselves, then subscribe to the project feed with Google Reader. Put the "Next" bookmarklet in your browser toolbar. Clicking on it will take you to the next item in the feed --not the next austere tag record but the full-text item tagged by the next tag record.
			*** Clearly this recommendation has been obsolete since Google pulled the plug on Reader in July 2014. If you know other tools with the same feature described here, please let us know.

	* '''Searching'''		* '''Searching'''
	** You can search the whole corpus of OATP tag records inside [http://tagteam.harvard.edu/ TagTeam]. You needn't be a registered TagTeam user to do so.		** You can search the whole corpus of OATP tag records inside [http://tagteam.harvard.edu/ TagTeam]. You needn't be a registered TagTeam user to do so.
	** ~~Similarly~~, if you subscribe to an OATP feed with Google Reader, then you can take advantage of its Google-based searching of the feed all the way back to the feed's beginning, even if you didn't start subscribing until some later date.		*** For details on the flexibility of the TagTEam search engine, see the [http://cyber.law.harvard.edu/hoap/TagTeam_basics#Searching section on searching] in the [http://cyber.law.harvard.edu/hoap/TagTeam_basics TagTeam manual].
			** If you subscribe to an OATP feed with Google Reader, then you can take advantage of its Google-based searching of the feed all the way back to the feed's beginning, even if you didn't start subscribing until some later date.
			*** Again, this powerful Google Reader feature is no longer available, and we welcome suggestions for other tools with the same feature.

	== Tips for taggers ==		== Tips for taggers ==

Petersuber: /* Tips for taggers */

2014-08-14T01:18:49Z

Tips for taggers

← Older revision		Revision as of 21:18, 13 August 2014
Line 67:		Line 67:

	* '''Adding original content'''		* '''Adding original content'''
	** To ~~put~~ an original piece of news or comment into the project feed, and make it available ~~to project~~ searches, first put it online in a way that gives it a unique URL (blog post, discussion forum contribution, wiki section, standalone web page). Then tag the online version.		** To insert an original piece of news or comment into the project feed, and make it available in OATP searches, first put it online in a way that gives it a unique URL (blog post, discussion forum contribution, wiki section, standalone web page). Then tag the online version.

	* '''Tagging events'''		* '''Tagging events'''
Line 77:		Line 77:

	* '''Neutral tagging'''		* '''Neutral tagging'''
	** Tagging an item for OATP is not an endorsement. If a new article ~~about~~ OA is strongly ~~critical~~, OATP still wants to include it. OATP provides alerts and organizes knowledge of the field. It leaves critique for articles, blog posts, forum discussions, conference presentations, and other venues.		** Tagging an item for OATP is not an endorsement. If a new article is relevant to OA, but you strongly disagree with hit, OATP still wants to include it. OATP provides alerts and organizes knowledge of the field. It leaves critique for articles, blog posts, forum discussions, conference presentations, and other venues.
			** The "description" box in the tagging dialog should also be a neutral excerpt or paraphrase. Don't use it to express opinions about the work you are tagging.
			*** If you're moved to write a rebuttal to a work you tag for OATP, don't do it in the OATP tag record. Write your rebuttal in a separate blog post (or other online location) and then tag your rebuttal.
	** The ''oa.negative'' tag is for objections, obstacles, or setbacks to OA, not for low-quality work about OA.		** The ''oa.negative'' tag is for objections, obstacles, or setbacks to OA, not for low-quality work about OA.
	** Some tagging platforms offer a "comment" box in addition to a "description" box. If your platform does so, then your "description" should be neutral, but your "comment" can be highly opinionated.		<!-- ** Some tagging platforms offer a "comment" box in addition to a "description" box. If your platform does so, then your "description" should be neutral, but your "comment" can be highly opinionated. -->

	* '''Identifying spam'''		* '''Identifying spam'''
Line 87:		Line 89:

	* '''Identifying countries and languages'''		* '''Identifying countries and languages'''
	** Tag countries and languages separately, e.g. ''oa.spain'' and ''oa.spanish''.		** Tag countries and languages separately, e.g. ''oa.argentina'' and ''oa.spanish'', even if they're very similar, e.g. ''oa.spain'' and ''oa.spanish''.

	== Tips for others ==		== Tips for others ==