OATP tips: Difference between revisions

From Open Access Directory
Jump to navigation Jump to search
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[File:oad2.jpeg|60px]] This list is part of the [http://oad.simmons.edu Open Access Directory].
This page [http://cyber.law.harvard.edu/hoap/OATP_tips moved] on May 24, 2015. Please update your bookmarks.
 
{| align="right"
  | __TOC__
  |}
 
<!-- <center>
{| class="wikitable" style="text-align:center" border="0" cellpadding="8" cellspacing="0"
| style="background:lightgray; color:black" |  &nbsp; This page has '''not''' yet been updated to reflect the transition from Connotea to TagTeam. it will be soon &nbsp;
|}
</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 ==
 
<!-- 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'''
** 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. 
** 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. 
 
* '''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.
** 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.
 
== 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'''
** 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 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.
 
* '''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'''
** If you tag an item that may not stay online long, such as a job ad, try to put all the relevant details in the description field for preservation.
 
* '''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.
** 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.
 
* '''Identifying spam'''
** If you see an item utterly unrelated to OA in a project feed, then take a moment to tag it with ''oa.spam''. 
** The [http://tagteam.harvard.edu/remix/oatp primary project feed] for OATP omits items tagged with ''oa.spam''. If you notice some spam in the feed, it's already too late for your tag to exclude the spam from the feed. But your tag will still help project managers identify spam (to exclude it from searches) and expel spammers.
<!-- ** Also see the [http://oad.simmons.edu/oadwiki/Talk:OA_tracking_project discussion] of this strategy for dealing with spam. -->
 
* '''Identifying countries and languages'''
** Tag countries and languages separately, e.g. ''oa.spain'' and ''oa.spanish''.
 
== 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> . -->

Latest revision as of 08:41, 24 May 2015

This page moved on May 24, 2015. Please update your bookmarks.