Intro to TagTeam: Difference between revisions

From Harvard Open Access Project
Jump to navigation Jump to search
(36 intermediate revisions by the same user not shown)
Line 3: Line 3:
   |}
   |}


* This page is part of the [http://cyber.law.harvard.edu/hoap Harvard Open Access Project] (HOAP).
* [[Main_Page|Harvard Open Access Project]] (HOAP) » [[TagTeam]] (TT) » '''Intro'''
<!-- * This page is part of the [http://cyber.law.harvard.edu/hoap Harvard Open Access Project] (HOAP).-->


* Suggested short URL for this page = [http://bit.ly/tagteam-intro bit.ly/tagteam-intro]
* Suggested short URL for this page = [http://bit.ly/tagteam-intro bit.ly/tagteam-intro]
Line 9: Line 10:
== General ==  
== General ==  


* [http://tagteam.harvard.edu/ TagTeam] is an open-source, social-tagging platform developed by [http://bit.ly/petersuber Peter Suber], [https://plus.google.com/104891670543808267868/about Dan Collis-Puro], and [http://cyber.law.harvard.edu/people/jclark Justin Clark].
* [http://tagteam.harvard.edu/ TagTeam] is an open-source tagging platform and feed aggregator developed for the [http://cyber.law.harvard.edu/hoap Harvard Open Access Project] under the supervision of [http://bit.ly/petersuber Peter Suber].
** Version 1.0 launched quietly in June 2012 and more publicly in September. Version 1.2 launched quietly in February 2013. Version 2.0 is under active development.
** Version 1.0 launched quietly in June 2012 and more publicly in September of the same year. Version 1.2 launched in February 2013. Version 1.5.2 launched in April 2014. Version 1.6 launched on July 1, 2015. Version 2.0 is under active development.
** TagTeam development is based at Harvard's [http://cyber.law.harvard.edu/ Berkman Center for Internet & Society] and funded by the [http://osc.hul.harvard.edu/liblab Harvard Library Lab].
** TagTeam development is based at Harvard's [http://cyber.law.harvard.edu/ Berkman Klein Center for Internet & Society]. The first three years of development were funded by the [http://osc.hul.harvard.edu/liblab Harvard Library Lab].
** The [https://github.com/berkmancenter/tagteam source code] is in GitHub.  
** The [https://github.com/berkmancenter/tagteam source code] is in GitHub under an [http://en.wikipedia.org/wiki/Affero_General_Public_License Affero General Public License] (AGPL).  
** An instance of TagTeam is [http://tagteam.harvard.edu/ running at Harvard University] for public use. However, users should not hesitate to download the code and install their own instances. The [http://oad.simmons.edu/oadwiki/OA_tracking_project Open Access Tracking Project] is running on the Harvard instance of TagTeam.
** An instance of TagTeam is [http://tagteam.harvard.edu/ running at Harvard University] for public use. However, users should not hesitate to download the [https://github.com/berkmancenter/tagteam code] and install their own instances.  
*** The [http://bit.ly/o-a-t-p Open Access Tracking Project] runs on the Harvard instance of TagTeam.
** Here's a [http://www.youtube.com/watch?v=ecXJu0DSPos video] of Peter Suber talking about TagTeam in November 2011, and [https://osc.hul.harvard.edu/liblab/proj/enhanced-social-tagging-classification-and-current-awareness another video] with an update from August 2013.
** Here's a [http://www.youtube.com/watch?v=ecXJu0DSPos video] of Peter Suber talking about TagTeam in November 2011, and [https://osc.hul.harvard.edu/liblab/proj/enhanced-social-tagging-classification-and-current-awareness another video] with an update from August 2013.


* To create an account on the Harvard instance of TagTeam, just go to the [http://tagteam.harvard.edu/ front page], click "log in" at the upper right corner, and sign up.
* To create an account on the Harvard instance of TagTeam, go to the [http://tagteam.harvard.edu/ front page], click [https://tagteam.harvard.edu/accounts/sign_in sign in] at the upper right corner, and sign up.  
<!-- [https://tagteam.harvard.edu/accounts/sign_in sign in page] and [https://tagteam.harvard.edu/accounts/sign_up sign up]. -->
<!-- [https://tagteam.harvard.edu/accounts/sign_in sign in page] and [https://tagteam.harvard.edu/accounts/sign_up sign up]. -->
** Once you've signed up, you may create TagTeam "hubs" or projects. You may always tag items for your own hubs, but you may only tag items for other hubs with the approval of the hub owner.
** Once you've signed up, you may create TagTeam "hubs" or projects. You may always tag items for your own hubs, but you may only tag items for other hubs with the approval of the hub owner.
** Note that since 2015, the Harvard instance of TagTeam limits new accounts to academic or research projects. In the sign-up process, you'll be asked to say something about your academic or research project.
** If you use the Harvard instance, then also see the [[TagTeam terms of service|terms of service]].
** See our short [[TagTeam basics|manual]] for instructions on how to use the major features. We'll expand and improve the manual over time, and welcome your feedback.


== Background ==  
== Background ==  


* The original idea behind TagTeam was to create a tool with the features needed by the [http://oad.simmons.edu/oadwiki/OA_tracking_project Open Access Tracking Project] (OATP) and not provided by other tagging platforms. Throughout development, we have been very conscious that a tool with the features needed by OATP would be useful to social-tagging projects on any topic.  
* The original idea behind TagTeam was to create a tool with the features needed by the [http://bit.ly/o-a-t-p Open Access Tracking Project] (OATP) and not already provided by other tagging platforms. Throughout development, we have been very conscious that a tool with the features needed by OATP would be useful to social-tagging projects on any topic.  
** TagTeam is a general-purpose tool, and not OATP-specific. OATP users who want to make the transition to the TagTeam version of the project should see the OATP [http://oad.simmons.edu/oadwiki/Transition_to_TagTeam transition handout].
** TagTeam is a general-purpose tool, and not OATP-specific.  
** All TagTeam tags, feeds, and searches are open access, making it especially useful for open-science and open-access research projects.  


* In addition to the standard features provided by most tagging platforms, we particularly wanted our tool...
* In addition to the standard features provided by most tagging platforms, we particularly wanted our tool to have these key features:
*# To free participants in the same social-tagging project to tag from the platforms of their choice. OATP started on Connotea (defunct since March 2013) but didn't want to limit project participants to Connotea or any other single platform. We call this feature ''interoperable tagging''.
*# ''Folksonomy in, ontology out.'' TagTeam allows user-defined tags on the input side to evolve into a standard vocabulary on the output side, under the control of project managers. This brings the benefits of user-defined tags (encouraging participation) as well as the benefits of a standard vocabulary (searching and organizing a body of knowledge).
*# To allow user-defined tags on the input side to evolve into a standard vocabulary on the output side, under the control of project managers. OATP wanted the benefits of user-defined tags, for encouraging participation, but also the benefits of a standard vocabulary, for searching and organizing a body of knowledge. We call this feature, ''folksonomy in, ontology out''.
*# ''Interoperable tagging.'' TagTeam frees participants in the same social-tagging project to use the tagging platforms of their choice. They needn't tag from TagTeam itself, or any other single platform. TagTeam can collect and unify their tags from different platforms (provided those platforms publish RSS feeds for each tag).
*# To weed out duplicates in the output feeds. If one purpose of an output feed is alerting readers to new developments, then duplicates in the feed are a bug, not a feature, and they annoy busy readers.  
*# ''Remix feeds.'' TagTeam can produce a new feed (in RSS, Atom, or JSON) from any boolean combination of component feeds, whether those component feeds are produced by TagTeam itself (e.g. its tags and searches) or by sources outside TagTeam.
*# To allow project managers to control spam. We want to allow social-tagging projects to support tagging from any interested users but also to block identified spam and spammers.
*# ''Deduped feeds.'' Like many other tagging platforms, TagTeam publishes an RSS feed for each tag. But unlike any others, it removes duplicate items from each feed. If one purpose of an output feed is alerting readers to new developments, then duplicates in the feed are a bug, not a feature, and they slow down busy readers.  
*# ''Spam control.'' TagTeam allows project managers to control spam by blocking identified spam and spammers.


== Features ==  
== Features ==  
Line 59: Line 66:
** For example, other tagging platforms allow users modify their own tags retroactively, and only their own. Ordinary TagTeam users have the same power. But TagTeam hub owners (project managers) may modify any tags in their hub, and may use both automated and manual filtering to do so. This is an essential tool for creating tag convergence or developing a project ontology.  
** For example, other tagging platforms allow users modify their own tags retroactively, and only their own. Ordinary TagTeam users have the same power. But TagTeam hub owners (project managers) may modify any tags in their hub, and may use both automated and manual filtering to do so. This is an essential tool for creating tag convergence or developing a project ontology.  


* It stores all tag records in a local database for deduping, back-up, export, modification, and searching. The search engine supports boolean searching, phrase searching, wildcard searching, and fuzzy searching.
* It stores all tag records in a local database for deduping, export, preservation, modification, and searching. The search engine supports boolean searching, phrase searching, wildcard searching, and fuzzy searching.


* It allows different hubs to share input feeds, and allow different hubs to give different local names to the same feed.  
* It allows different hubs to share input feeds, and allow different hubs to give different local names to the same feed.  

Revision as of 08:52, 21 March 2018

General

  • To create an account on the Harvard instance of TagTeam, go to the front page, click sign in at the upper right corner, and sign up.
    • Once you've signed up, you may create TagTeam "hubs" or projects. You may always tag items for your own hubs, but you may only tag items for other hubs with the approval of the hub owner.
    • Note that since 2015, the Harvard instance of TagTeam limits new accounts to academic or research projects. In the sign-up process, you'll be asked to say something about your academic or research project.
    • If you use the Harvard instance, then also see the terms of service.
    • See our short manual for instructions on how to use the major features. We'll expand and improve the manual over time, and welcome your feedback.

Background

  • The original idea behind TagTeam was to create a tool with the features needed by the Open Access Tracking Project (OATP) and not already provided by other tagging platforms. Throughout development, we have been very conscious that a tool with the features needed by OATP would be useful to social-tagging projects on any topic.
    • TagTeam is a general-purpose tool, and not OATP-specific.
    • All TagTeam tags, feeds, and searches are open access, making it especially useful for open-science and open-access research projects.
  • In addition to the standard features provided by most tagging platforms, we particularly wanted our tool to have these key features:
    1. Folksonomy in, ontology out. TagTeam allows user-defined tags on the input side to evolve into a standard vocabulary on the output side, under the control of project managers. This brings the benefits of user-defined tags (encouraging participation) as well as the benefits of a standard vocabulary (searching and organizing a body of knowledge).
    2. Interoperable tagging. TagTeam frees participants in the same social-tagging project to use the tagging platforms of their choice. They needn't tag from TagTeam itself, or any other single platform. TagTeam can collect and unify their tags from different platforms (provided those platforms publish RSS feeds for each tag).
    3. Remix feeds. TagTeam can produce a new feed (in RSS, Atom, or JSON) from any boolean combination of component feeds, whether those component feeds are produced by TagTeam itself (e.g. its tags and searches) or by sources outside TagTeam.
    4. Deduped feeds. Like many other tagging platforms, TagTeam publishes an RSS feed for each tag. But unlike any others, it removes duplicate items from each feed. If one purpose of an output feed is alerting readers to new developments, then duplicates in the feed are a bug, not a feature, and they slow down busy readers.
    5. Spam control. TagTeam allows project managers to control spam by blocking identified spam and spammers.

Features

TagTeam is a versatile, open-source, social-tagging platform and feed aggregator. It lets members of a research project tag online resources (articles, books, datasets, news stories, and so on) to alert subscribers to new developments or to organize knowledge in the field. Other tagging platforms already offer rudimentary versions of these services. TagTeam goes further by allowing user-defined tags or folksonomies to evolve into standard vocabularies or ontologies under the direction of project managers. In addition, TagTeam combines the contributions of project participants even if they do not all use the same tagging platform, and even if they do not use TagTeam.

From another point of view, TagTeam is a mashup engine for social-tagging projects. It can integrate the tags and tag feeds from multiple tagging platforms. After making its own copies of these tag records, it supports many kinds of targeted modification and combination. Then it publishes outputs in standard formats, like XML, for further mashups by other projects. At the same time, it stores all the tag records to which it subscribes, and added by users, for flexible, boolean searching.

  • TagTeam supports any number of hubs or social-tagging projects. Each hub can subscribe to any number of input feeds and publish any number of output feeds.
  • It accepts input feeds from different tagging platforms, such as Delicious and CiteULike. It accepts inputs from any tagging platform that generates RSS or Atom feeds for its tags. It can accept these inputs either by subscribing to the tag feeds or by importing files of tag records.
  • It integrates tags created on different tagging platforms.
    • For example, if some members of a research project use Delicious, some use CiteULike, and some use TagTeam itself, and if they agree on a common tag for project-related resources, then TagTeam can publish a unified feed of all the the items they tag with that tag, regardless of the tagging platform they used. If members of the project agree on a set of common tags (a vocabulary or ontology), TagTeam can publish a set of unified feeds.
  • It supports tagging through its own bookmarklet, for users who prefer to tag directly from TagTeam rather than from a supported platform such as Delicious or CiteULike. It generates RSS, Atom, and JSONP feeds for each of its tags. Other services online can easily convert these to Twitter or email feeds.
  • It supports both automated and manual modification of input feeds, feed items, and item tags. All modifications of both kinds show up in searches and output feeds.
    • Automated filtering allows a project to convert deprecated tags to approved tags. Automated filters are both retroactive (changing all stored occurrences of a tag) and prospective (changing all future occurrences).
    • Manual filtering allows a project to delete spam, and to correct tagging mistakes too difficult to correct algorithmically.
  • It removes duplicate records from searches and output feeds, and merges the tags used in duplicate records.
    • For example, if two users tag the same item, one with tags A and B, and the other with tags B and C, then TagTeam will store and publish only one record of the item, with tags A, B, and C.
  • It supports user roles, allowing access to advanced features for some users and not others.
    • For example, other tagging platforms allow users modify their own tags retroactively, and only their own. Ordinary TagTeam users have the same power. But TagTeam hub owners (project managers) may modify any tags in their hub, and may use both automated and manual filtering to do so. This is an essential tool for creating tag convergence or developing a project ontology.
  • It stores all tag records in a local database for deduping, export, preservation, modification, and searching. The search engine supports boolean searching, phrase searching, wildcard searching, and fuzzy searching.
  • It allows different hubs to share input feeds, and allow different hubs to give different local names to the same feed.
  • It allows users to create output feeds from any boolean combination of input feeds or any boolean combination of tags.
  • It spiders or updates its input feeds often enough for its output feeds to provide useful real-time alerts. Hence it combines a prospective alert service with a retrospective knowledge-organization service.