Document intro to Wikimedia technical areas
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	srishakatux
	Jul 26 2017, 8:56 PM

Description

Reopening this task for 2022-2023 July because we in Dev Advocacy started working on a draft document that can be placed on-wiki but which is based on much of this past information and diagrams that Srishti and others created. I need a tracking task to keep me accountable to finish the editing and diagram updates, but it seemed silly to create a new task when this one has so much related info.

Past task info:
Once T171787 is resolved, put together a concise documentation around Wikimedia technical areas expanding what we currently have in https://upload.wikimedia.org/wikipedia/commons/2/27/Wikimedia_Technical_Areas_An_Overview.pdf.

Link to the documentation for technical areas in whatever format produced (on-wiki or pdf) will be linked from the New Developers page.

We could also consider making a video with voiceover when we know the documentation is up to date.

Details

	Subject	Repo	Branch	Lines +/-
	content: Replace tech overview link with new doc. Update gadgets.	wikimedia/developer-portal	main	+9 -9

Customize query in gerrit

Related Objects
Search...

Status	Assigned	Task
Resolved	srishakatux	T164084 [FY 17-18] Program 12: Onboarding new developers
Resolved	Aklapper	T176490 Goal: A learning environment and growth paths for new volunteer developers
Resolved	None	T169599 Sort out concept for overview/entrance pages targeting our developer audience
Resolved	TBurmeister	T171789 Document intro to Wikimedia technical areas

Event Timeline

srishakatux created this task.Jul 26 2017, 8:56 PM

bd808 subscribed.Jul 26 2017, 10:06 PM

Qgil moved this task from Backlog to Ready to Go on the Developer-Advocacy (Jul-Sep 2017) board.Aug 3 2017, 11:38 AM

Just noting: if the PDF file c:File:Wikimedia_Technical_Areas_An_Overview.pdf continued to get used,

non-generic sentences like "Mentors XYZ attending Wikimania" would need to get removed.
As a volunteer potentially wanting to use those slides, I'd be curious how to find 'the source' as PDF files are hard to remix / edit.

(I checked these slides again today as we'll kill the use of Ruby in QA's Selenium tests soon, but I see that the slides don't mention Ruby with regard to QA. Yay.)

@Aklapper Agree! In any case, I think that the slides don't convey much info, and so I am planning to document the technical areas either on a new page or merge with existing "how to contribute". I will come up with a draft soon and share.

Link to the documentation for technical areas in whatever format produced (on-wiki or pdf) will be linked from the New Developers page.

I am not convinced that is the best idea:
In which specific situation do I, as a beginner, need to have an overview of the technical areas in Wikimedia?
(When I started contributing to software project X in organization Y, I did not care much about organization Y and did not need to know much about it. True story.)

Maybe it could be linked from https://www.mediawiki.org/wiki/New_Developers#Looking_for_additional_resources.3F or linked from one of the page listed in that very section.

I might be wrong here, hence discussion welcome.

srishakatux raised the priority of this task from Medium to High.Oct 4 2017, 6:37 AM

srishakatux moved this task from Jul-Sep 2017 to Oct-Dec 2017 on the Developer-Advocacy board.

srishakatux edited projects, added Developer-Advocacy (Oct-Dec 2017); removed Developer-Advocacy (Jul-Sep 2017).

Qgil moved this task from Backlog to Ready to Go on the Developer-Advocacy (Oct-Dec 2017) board.Oct 4 2017, 9:20 AM

srishakatux lowered the priority of this task from High to Medium.Oct 4 2017, 7:07 PM

srishakatux raised the priority of this task from Medium to Needs Triage.Jan 2 2018, 9:43 PM

srishakatux moved this task from Oct-Dec 2017 to To triage on the Developer-Advocacy board.

srishakatux edited projects, added Developer-Advocacy; removed Developer-Advocacy (Oct-Dec 2017).

srishakatux triaged this task as Medium priority.Jan 2 2018, 9:47 PM

@srishakatux: Any thoughts / input on T171789#3653889 ?

In T171789#3878771, @Aklapper wrote:

@srishakatux: Any thoughts / input on T171789#3653889 ?

@Aklapper Yes, you are right! Maybe I am too lazy, but this task no longer seems valid to me :-/

In T171789#3533022, @Aklapper wrote:

Just noting: if the PDF file c:File:Wikimedia_Technical_Areas_An_Overview.pdf continued to get used,

non-generic sentences like "Mentors XYZ attending Wikimania" would need to get removed.

As a volunteer potentially wanting to use those slides, I'd be curious how to find 'the source' as PDF files are hard to remix / edit.

Good point! I have added a link to the PDF source in the file description on Commons. Folks can re-use, copy, comment on slides, etc. Unless there is more to add, I can close this task.

In T171789#3888916, @srishakatux wrote:

Unless there is more to add, I can close this task.

@srishakatux: I'd say: Do it. (And add DevRel's quarterly project/month column to track this task.)

srishakatux closed this task as Resolved.Mar 8 2018, 5:56 AM

srishakatux edited projects, added Developer-Advocacy (Oct-Dec 2018); removed Developer-Advocacy.

Gryllida subscribed.Mar 8 2018, 5:58 AM

Aklapper edited projects, added Developer-Advocacy (Jan-Mar-2018); removed Developer-Advocacy (Oct-Dec 2018).Mar 8 2018, 11:40 AM

Related: T171787, T1287

TBurmeister moved this task from To triage to Jul-Sep 2022 on the Developer-Advocacy board.Jul 14 2022, 4:53 PM

TBurmeister edited projects, added Developer-Advocacy (Jul-Sep 2022); removed Developer-Advocacy.

TBurmeister edited projects, added Developer-Advocacy (Oct-Dec 2022); removed Developer-Advocacy (Jul-Sep 2022).Oct 17 2022, 8:15 PM

• nskaggs subscribed.Oct 25 2022, 3:44 PM

TBurmeister moved this task from To-Do to In Progress on the Developer-Advocacy (Oct-Dec 2022) board.Oct 25 2022, 6:55 PM

I've completed a final draft for this. It has been reviewed by multiple members of Tech Engagement along with by other tech writers and by attendees of the Wikimania local meetup in Pittsburgh, who graciously offered to provide input. All these iterations and revisions resulted in the version now being prepared for final publication in my sandbox:
https://www.mediawiki.org/wiki/User:TBurmeister_(WMF)/Sandbox/Ecosystem_intro

This is now published at https://www.mediawiki.org/wiki/New_Developers/Introduction_to_the_Wikimedia_Technical_Ecosystem and linked from:

Patch forthcoming to link to it from https://developer.wikimedia.org/get-started/wikimedia-tech/

Change 865714 had a related patch set uploaded (by Triciaburmeister; author: Triciaburmeister):

[wikimedia/developer-portal@main] content: Replace tech overview link with new doc. Update gadgets.

https://gerrit.wikimedia.org/r/865714

gerritbot added a project: Patch-For-Review.Dec 7 2022, 5:23 PM

srishakatux awarded a token.Dec 7 2022, 8:02 PM

Quiddity awarded a token.Dec 7 2022, 10:07 PM

Change 865714 merged by jenkins-bot:

[wikimedia/developer-portal@main] content: Replace tech overview link with new doc. Update gadgets.

https://gerrit.wikimedia.org/r/865714

jenkins-bot mentioned this in rWDPO747f1f9c8418: content: Replace tech overview link with new doc. Update gadgets..Dec 9 2022, 4:36 PM