Portal:Toolforge: Difference between revisions

From Wikitech
Content deleted Content added
remove extra blank line
m Reverted edit by NoobThreePointOh (talk) to last revision by Triciaburmeister
Tag: Rollback
 
(54 intermediate revisions by 29 users not shown)
Line 1: Line 1:
{{See|toolforge.org redirects here. You might be looking for the [[:Category:Toolforge tools|Lists of Toolforge tools]].}}
{{Template:Toolforge nav}}
{{Anchor|Overview}}
{{Mbox|image=[[File:Ambox PR.svg|40x40px|link=|alt=]]|text=Please read [[Help:Cloud Services Introduction|Wikimedia Cloud Services Introduction]] and the [[Help:Getting Started|Getting Started guide]].}}
{{#lst:Help:Toolforge|whatis}}
{{Clear}}
{{Prefix search|prefix="Help:Tool"|placeholder=Search Toolforge Documentation|button=Go}}


<div style="text-align:center;">
[[File:Toolforge logo with text.svg|right|120px|alt=Toolforge logo]]
{{ContentGrid

|content=
{{draft}}
{{Colored box

|title = Deploy your tool on Toolforge
== Overview ==
|content = Use Toolforge to host and maintain tools.<br />

{{Clickable button 2|Go to the Toolforge user docs|class=mw-ui-progressive|url=https://wikitech.wikimedia.org/wiki/Help:Toolforge}}
{{#lst:About Toolforge|whatis}}
}}

{{Colored_box
This page contains links to documentation for tool developers, maintainers, and Toolforge administrators.
|title = Administer Toolforge

|content = Manage the Toolforge platform and its infrastructure.<br />
<noinclude>__NOTOC__ [[Category:Portals|Toolforge]][[Category:Toolforge| ]]</noinclude>
{{Clickable button 2|Go to the Toolforge admin docs|class=mw-ui-progressive|url=https://wikitech.wikimedia.org/wiki/Portal:Toolforge/Admin}}

}}
== Toolforge quickstart ==
}}
<section begin=quickstart />
</div>
Ready to get started with Toolforge? Follow these steps:

# [[Help:Create a Wikimedia developer account|Create a Wikimedia developer account]].
# [[mw:Gerrit/Tutorial#Generate a new SSH key|Create an SSH key]] and [[Special:Preferences#mw-prefsection-openstack|add it to your Wikitech account]].
# Submit a [https://toolsadmin.wikimedia.org/tools/membership/apply Toolforge project membership request] and wait for its approval.
#* Your request will be reviewed, and you will receive confirmation within a week. You will be notified through your Wikitech user account.
# Once you are added as a Toolforge member, you must logout and then login again at https://toolsadmin.wikimedia.org/
#* Doing this is required for your membership to take effect.
# [[Help:Toolforge#Creating a new Tool account|Create a new tool]] or [[Help:Toolforge#Joining an existing Tool account|join an existing Tool account]]
# [[Help:Access#Accessing Toolforge instances|Access]] the Toolforge project and [[Help:Toolforge#Updating files|manage your files]].<section end=quickstart />

== Toolforge documentation ==

=== Tool developer/maintainer documentation ===

* [[About Toolforge]]: What is Toolforge? What do you need to know to join the Toolforge community and start developing tools? Learn the basics!
* [[Help:Toolforge|Toolforge Help]]: What is a Tool Account? How do you use it to build tools and make contributions to Wikimedia projects? Learn how to follow basic Toolforge workflows to create and maintain tools using Tool Accounts.

=== Toolforge administration documentation ===
Documentation for administrators of the Toolforge service itself can be found at [[Portal:Toolforge/Admin]].


{{:Help:Cloud Services communication}}
{{:Help:Cloud Services communication}}
<noinclude>
__NOTOC__
[[Category:Portals|Toolforge]]
[[Category:Toolforge]]
[[Category:Documentation]]
</noinclude>

Latest revision as of 21:36, 3 February 2024

Toolforge is a free cloud hosting platform for Wikimedia contributors. It provides web servers, data access, job management, and other features to help developers maintain tools and bots.

Toolforge is part of the Wikimedia Cloud Services (WMCS) suite of services. It is supported by Wikimedia Foundation staff and volunteers.

Deploy your tool on Toolforge

Use Toolforge to host and maintain tools.
Go to the Toolforge user docs

Administer Toolforge

Manage the Toolforge platform and its infrastructure.
Go to the Toolforge admin docs

Communication and support

Support and administration of the WMCS resources is provided by the Wikimedia Foundation Cloud Services team and Wikimedia movement volunteers. Please reach out with questions and join the conversation:

Discuss and receive general support
Stay aware of critical changes and plans
Track work tasks and report bugs

Use a subproject of the #Cloud-Services Phabricator project to track confirmed bug reports and feature requests about the Cloud Services infrastructure itself

Read stories and WMCS blog posts

Read the Cloud Services Blog (for the broader Wikimedia movement, see the Wikimedia Technical Blog)