Revision as of 05:41, 27 January 2016

Tool Labs	Getting started • Help • Rules • Access • Database • Grid • Web • How to

Tool Labs

Tool Labs (or Tools) is a hosting environment for community developers working on tools and bots that help users maintain and use wikis. Tool Labs provides access to replicas of Wikimedia databases, allowing developers to easily re-use this information for analytics, bot work, or by creating tools that help editors and other volunteers in their work. The infrastructure is supported by a dedicated group of Wikimedia Foundation staff and volunteers.

All Tool Labs web applications are served through tools.wmflabs.org.

For more information pertaining to the Tool Labs environment, please see Help:Tool Labs.

Terms of use

Tool Labs is subject to the Wikimedia Labs Terms of Use.
Tool Labs projects must be open source software licensed under an OSI approved license.
Tool Labs projects must not to collect, store, or share private data or personally identifiable information, such as user names, passwords, or IP addresses, except when complying with the conditions listed in the Wikimedia Labs Terms of Use.

Quick start

Create an account here on the Wikitech wiki.
- Wikitech accounts have two names: the wiki username and "Instance shell account name".
  - Your wiki username and password will be used to login here on Wikitech and on Gerrit.
  - Your shell name will be used when you interact with servers via ssh and when using git with Gerrit.
Set up an SSH key that you will use along with your shell account name to log into the Tool Labs servers if you do not already have one. See Help:Tool_Labs/Access § Generating and uploading an SSH key for additional help.
Associate your SSH public key with your Wikitech account using the Preferences > OpenStack tab.
Fill out an access request to join the Tools project.
Wait for your access request for the Tools project to be processed (you should receive messages on your Wikitech talk page).

@@ Line 1: / Line 1: @@
+<!-- TODO: move to [[Template:Tool Labs nav]] -->
+{{Nmbox
+ | header = '''[[User:BryanDavis/NewPortals/Tool Labs|Tool Labs]]'''
+ | image = [[File:Tool_labs_logo.svg|30px|link=|alt=]]
+ | text = [[Help:Tool_Labs/Getting started|Getting started]] &bull; [[Help:Tool_Labs|Help]] &bull; [[Nova_Resource:Tools/Rules|Rules]] &bull; [[Help:Tool_Labs/Access|Access]] &bull; [[Help:Tool Labs/Database|Database]] &bull; [[Help:Tool Labs/Grid|Grid]] &bull; [[Help:Tool Labs/Web|Web]] &bull; [[Nova_Resource:Tools/How to|How to]]
+}}
+<!-- end [[Template:Tool Labs nav]] -->
 = Tool Labs =
 [[File:Tool_labs_logo.svg|right|120px|alt=Wikimedia Tool Labs logo|link=/Tool Labs]]
-'''Tool Labs''' (or '''Tools''') is a hosting environment for community developers working on tools and bots that help users maintain and use wikis. Tool Labs provides access to replicas of Wikimedia databases, allowing developers to easily re-use this information for analytics, bot work, or by creating tools that help editors and other volunteers in their work. The infrastructure is supported by a dedicated group of Wikimedia Foundation staff and volunteers.
+'''Tool Labs''' (or '''Tools''') is a hosting environment for community developers working on tools and bots that help users maintain and use wikis. Tool Labs provides access to [[Help:Tool_Labs/Database|replicas of Wikimedia databases]], allowing developers to easily re-use this information for analytics, bot work, or by creating tools that help editors and other volunteers in their work. The infrastructure is supported by a dedicated [[Nova_Resource:Tools|group of Wikimedia Foundation staff and volunteers]].
-All Tool Labs web applications are served through [https://tools.wmflabs.org/ tools.wmflabs.org]. The main page provides an overview of user groups. Tool Labs supersedes the "Toolserver" previously run by Wikimedia Deutschland.
+All Tool Labs web applications are served through [https://tools.wmflabs.org/ tools.wmflabs.org].
-The Tool Labs platform is powered by Wikimedia Labs, but this aspect is not relevant to its users.
 For more information pertaining to the Tool Labs environment, please see [[Help:Tool Labs]].
@@ Line 16: / Line 22: @@
 == Quick start ==
-# [[Special:UserLogin/signup|Create an account]] here on the wikitech wiki.
+# [[Special:UserLogin/signup|Create an account]] here on the Wikitech wiki.
-#* Make careful note of the ''wiki username'' and "Instance ''shell'' account name" you choose
+#* Wikitech accounts have two names: the ''wiki username'' and "Instance ''shell'' account name".
+#** Your wiki username and password will be used to login here on Wikitech and on [[:mw:Gerrit|Gerrit]].
+#** Your shell name will be used when you interact with servers via [[Help:Tool_Labs/Access|ssh]] and when using [[:mw:Gerrit/Getting_started|git with Gerrit]].
 # [[:mw:Gerrit/Tutorial#Set Up SSH Keys in Gerrit|Set up an SSH key]] that you will use along with your ''shell'' account name to log into the Tool Labs servers if you do not already have one. See {{section link|Help:Tool_Labs/Access|Generating and uploading an SSH key}} for additional help.
-# Associate your SSH public key with your wikitech account using the [[Special:Preferences#mw-prefsection-openstack|Preferences > OpenStack tab]].
+# Associate your SSH public key with your Wikitech account using the [[Special:Preferences#mw-prefsection-openstack|Preferences > OpenStack tab]].
 # [[Special:FormEdit/Tools Access Request|Fill out an access request to join the Tools project]].
-# Wait for your access request for the Tools project to be processed (you should receive messages on your [[Special:MyTalk | wikitech talk page]]).
+# Wait for your access request for the Tools project to be processed (you should receive messages on your [[Special:MyTalk | Wikitech talk page]]).
 {{See also|Help:Tool_Labs/Access}}
 <noinclude>__NOTOC__</noinclude>