Page MenuHomePhabricator
Create Task
Maniphest T101659

Run a documentation sprint for Cloud VPS and Toolforge
Closed, DeclinedPublic
Actions

Description

Currently documentation is way too out of date and inconsistent. Setup a weeklong sprint with specific tasks to fix documentation, and run the weeklong sprint, with help from Admins and volunteers.

Should involve both general Cloud VPS and Toolforge.

See also:

Related Objects
Search...

StatusSubtypeAssignedTask
 ResolvedLea_Lacroix_WMDET187319 Documentation sprint @Hackathon 2018
 DeclinedNoneT101659 Run a documentation sprint for Cloud VPS and Toolforge
 Resolvedbd808T101687 Explicitly document policies for requesting new projects
 ResolvedNoneT101756 Document each set of hosts on Toolforge properly
 OpenNoneT126094 Create a "Beginners guide to creating a Cloud VPS instance" wiki page
 OpenNoneT134493 Create a "my first PHP webservice" tutorial for Toolforge
 OpenNoneT134494 Create a "my first Python webservice" tutorial for Toolforge
 ResolvedMridu_BhatnagarT177149 [Outreachy] - Improvement in Documentation.
 In ProgressSlst2020T331724 [tbs] Create documentation on how to build and deploy a python application
 In ProgressKBachT134495 Create a "my first Pywikibot bot" tutorial for Toolforge
 OpenFeatureNoneT63824 Document how to install Python modules in a tool's home directory/virtual environment
 Resolved• chasempT156340 Update Tool Labs account creation docs on wikitech to mention Striker
 Resolved• srodlundT155108 Wikitech/horizon/striker 2fa documentation
 Resolved• srodlundT91509 Re-organize wikitech:Help:Toolforge documentation
 OpenNoneT165002 Make a page of database usage tips
 Resolvedbd808T165403 Document basics of using a custom Kubernetes "Deployment" to operate a tool
 ResolvedaborreroT100529 Document, explain, diagram labs vlans and network setup
 ResolvedJproramaT172855 Create visual diagram of documented components of Toolforge Kubernetes cluster
 DuplicateNoneT187659 Document virtualenv creation in Toolforge
 ResolvedsrishakatuxT192423 Create a "my first NodeJS OAuth tool" tutorial for Toolforge
 OpenNoneT193681 Tutorial for running continuous or cron-like jobs via Python on Toolforge
 OpenNoneT202949 Compile the frequently used webpage design snippets for Tools authors

Event Timeline

yuvipanda created this task.Jun 7 2015, 9:33 PM
yuvipanda raised the priority of this task from to Needs Triage.
yuvipanda updated the task description. (Show Details)
yuvipanda added a project: Toolforge.
yuvipanda added subscribers: yuvipanda, Multichill, valhallasw, coren.
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptJun 7 2015, 9:33 PM
yuvipanda renamed this task from Run a documentation sprint for Tool Labs to Run a documentation sprint for Labs.Jun 8 2015, 9:14 AM
yuvipanda set Security to None.
yuvipanda updated the task description. (Show Details)
yuvipanda added projects: Cloud-Services, Documentation.
yuvipanda mentioned this in T101325: Create labs project for Reading department.
Sitic added a subscriber: Sitic.Jun 8 2015, 3:14 PM
yuvipanda merged a task: T101006: Setup a documentation sprint for Tool Labs / Labs.Jun 16 2015, 10:00 AM
valhallasw triaged this task as Low priority.Jul 2 2015, 7:43 PM
valhallasw moved this task from Triage to Backlog on the Toolforge board.Jul 2 2015, 7:46 PM
bd808 added a subtask: T126094: Create a "Beginners guide to creating a Cloud VPS instance" wiki page.Feb 23 2016, 6:31 AM
Matthewrbowker added a subscriber: Matthewrbowker.Feb 23 2016, 6:31 AM
Dzahn added a subscriber: Dzahn.Feb 23 2016, 6:58 AM

Can we add the labs part of T127797 ?

Qgil mentioned this in T126500: Organize a MediaWiki Documentation Day (similar to the Gerrit Cleanup Day) on 2017-05-12.Mar 10 2016, 9:57 PM
Qgil added a project: Developer-Advocacy.
Qgil updated the task description. (Show Details)
bd808 added a project: Community-Tech-Tool-Labs.Mar 24 2016, 11:53 PM
tom29739 added a subscriber: tom29739.Mar 25 2016, 1:23 PM
Dzahn removed a subscriber: Dzahn.Mar 25 2016, 2:57 PM
Qgil moved this task from To triage to Team radar on the Developer-Advocacy board.Apr 1 2016, 7:09 PM
Qgil added a subscriber: Qgil.Apr 26 2016, 8:37 AM

Would this task or any of the subtasks be a good candidate for Wikimania-Hackathon-2016? We are looking for tasks for newcomers / not very tech participants -- see T132721: Wikimania 2016 Hackathon Goals.

bd808 created subtask T134493: Create a "my first PHP webservice" tutorial for Toolforge.May 5 2016, 3:09 PM
bd808 created subtask T134494: Create a "my first Python webservice" tutorial for Toolforge.May 5 2016, 3:12 PM
bd808 created subtask T134495: Create a "my first Pywikibot bot" tutorial for Toolforge.
• Purodha added a subscriber: • Purodha.May 6 2016, 7:13 AM
Ricordisamoa added a subscriber: Ricordisamoa.May 6 2016, 11:20 AM
Danny_B moved this task from Backlog to Cloud Services on the Documentation board.May 6 2016, 10:25 PM
• chasemp added a subscriber: • chasemp.May 11 2016, 2:03 PM
In T101659#2238481, @Qgil wrote:

Would this task or any of the subtasks be a good candidate for Wikimania-Hackathon-2016? We are looking for tasks for newcomers / not very tech participants -- see T132721: Wikimania 2016 Hackathon Goals.

Neat thought. Is there a hackathon as part of wikimania again? This could be a cool candidate. I would be interested.

Aklapper added a comment.May 11 2016, 6:00 PM
In T101659#2285264, @chasemp wrote:

Is there a hackathon as part of wikimania again?

Yes.

Qgil added a parent task: T132624: Pre-Wikimania Hackathon 2016 Content Work.May 12 2016, 10:18 AM
In T101659#2285264, @chasemp wrote:

I would be interested.

You got it! :)

valhallasw closed subtask T134494: Create a "my first Python webservice" tutorial for Toolforge as Resolved.May 27 2016, 12:49 PM
bd808 reopened subtask T134494: Create a "my first Python webservice" tutorial for Toolforge as Open.May 27 2016, 3:04 PM
Aklapper removed a parent task: T132624: Pre-Wikimania Hackathon 2016 Content Work.Jul 25 2016, 2:28 PM
zhuyifei1999 added a subscriber: zhuyifei1999.Aug 11 2016, 11:51 AM
Qgil added a project: Developer-Wishlist (2017).Jan 17 2017, 9:09 AM
Jdforrester-WMF moved this task from To Be Triaged to Documentation on the Developer-Wishlist (2017) board.Jan 18 2017, 4:09 PM
Giftpflanze added a subscriber: Giftpflanze.Jan 21 2017, 1:40 PM
zhuyifei1999 mentioned this in T156386: Create a wall for tools migration to trusty.Feb 2 2017, 2:36 PM
srishakatux added a subscriber: srishakatux.Feb 3 2017, 11:35 PM

This project is selected for the Developer-Wishlist voting round and will be added to a MediaWiki page very soon. To the subscribers, or proposer of this task: please help modify the task description: add a brief summary (10-12 lines) of the problem that this proposal raises, topics discussed in the comments, and a proposed solution (if there is any yet). Remember to add a header with a title "Description," to your content. Please do so before February 5th, 12:00 pm UTC.

Xephyr826 added a subscriber: Xephyr826.Feb 21 2017, 6:47 AM
Tgr mentioned this in T158148: Promote Developer Wishlist 2017 proposals.Feb 28 2017, 1:31 AM
Quiddity added a subscriber: Quiddity.Mar 3 2017, 1:27 AM
bd808 added a subtask: T63824: Document how to install Python modules in a tool's home directory/virtual environment.Apr 26 2017, 11:05 PM
bd808 added a subtask: T156340: Update Tool Labs account creation docs on wikitech to mention Striker.
bd808 added a subtask: T155108: Wikitech/horizon/striker 2fa documentation.
bd808 added a subtask: T91509: Re-organize wikitech:Help:Toolforge documentation.Apr 26 2017, 11:07 PM
Qgil added a comment.Apr 27 2017, 9:24 AM

Can any of these subtasks be connected with the WriteTheDocs activities coming to San Francisco and Portland?

srishakatux added a comment.Apr 27 2017, 9:29 PM

@Qgil Yes! This is happening. Planning on showcasing the subtasks at both the events.

bd808 created subtask T165002: Make a page of database usage tips.May 11 2017, 1:14 AM
bd808 created subtask T165403: Document basics of using a custom Kubernetes "Deployment" to operate a tool.May 15 2017, 9:30 PM
bd808 closed subtask T156340: Update Tool Labs account creation docs on wikitech to mention Striker as Resolved.May 31 2017, 2:40 AM
• Phabricator_maintenance removed a subscriber: yuvipanda.Jun 7 2017, 6:50 PM
Quiddity renamed this task from Run a documentation sprint for Labs to Run a documentation sprint for Cloud VPS and Toolforge.Jul 29 2017, 1:15 AM
Quiddity removed projects: Community-Tech-Tool-Labs, Cloud-Services.
Quiddity updated the task description. (Show Details)
Quiddity removed a subscriber: • Purodha.
bd808 closed subtask T165403: Document basics of using a custom Kubernetes "Deployment" to operate a tool as Resolved.Sep 16 2017, 12:09 AM
Quiddity added a parent task: T187319: Documentation sprint @Hackathon 2018.Apr 13 2018, 10:37 PM
Quiddity added a subtask: T100529: Document, explain, diagram labs vlans and network setup.Apr 13 2018, 10:57 PM
Quiddity added a subtask: T172855: Create visual diagram of documented components of Toolforge Kubernetes cluster.
Quiddity added a subtask: T180513: Document wiki-replicas architecture for future automation.Apr 13 2018, 10:59 PM
Quiddity removed a subtask: T101690: Cleanup https://wikitech.wikimedia.org/wiki/Nova_Resource:Tools.Apr 13 2018, 11:01 PM
Quiddity added a subtask: T187659: Document virtualenv creation in Toolforge.
Quiddity added a subtask: T192423: Create a "my first NodeJS OAuth tool" tutorial for Toolforge.Apr 19 2018, 5:33 PM
Quiddity added a subtask: T193681: Tutorial for running continuous or cron-like jobs via Python on Toolforge.May 2 2018, 9:25 PM
bd808 closed subtask T101687: Explicitly document policies for requesting new projects as Resolved.Jun 15 2018, 10:58 PM
srishakatux closed subtask T192423: Create a "my first NodeJS OAuth tool" tutorial for Toolforge as Resolved.Jul 3 2018, 2:46 AM
• srodlund moved this task from Cloud Services to Completed, Blocked, Wrong Category, Refinement Needed, or Older Needs Review on the Documentation board.Aug 14 2018, 8:40 PM
Bstorm closed subtask T180513: Document wiki-replicas architecture for future automation as Resolved.Oct 23 2019, 6:09 PM
aborrero closed subtask T172855: Create visual diagram of documented components of Toolforge Kubernetes cluster as Resolved.Mar 2 2020, 5:23 PM
• srodlund closed subtask T155108: Wikitech/horizon/striker 2fa documentation as Resolved.Jun 25 2020, 8:51 PM
Bstorm removed a subtask: T180513: Document wiki-replicas architecture for future automation.Nov 17 2020, 12:20 AM
taavi closed subtask T101756: Document each set of hosts on Toolforge properly as Resolved.Oct 9 2021, 5:10 PM
Aklapper closed this task as Declined.Jan 10 2022, 6:29 PM

Boldly declining this task after 6.5 years. Anyone feel free to reopen if they actively plan such a weekend.

Aklapper closed subtask T91509: Re-organize wikitech:Help:Toolforge documentation as Resolved.Jan 10 2022, 6:32 PM
Aklapper mentioned this in T288833: Improve documentation for pywikibot.Jan 10 2022, 6:43 PM
KBach changed the status of subtask T134495: Create a "my first Pywikibot bot" tutorial for Toolforge from Open to In Progress.Jan 11 2023, 12:23 PM
taavi closed subtask T100529: Document, explain, diagram labs vlans and network setup as Resolved.Feb 7 2023, 10:02 AM
Content licensed under Creative Commons Attribution-ShareAlike 3.0 (CC-BY-SA) unless otherwise noted; code licensed under GNU General Public License (GPL) or other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL