Page MenuHomePhabricator

Create documentation for contributors
Closed, ResolvedPublic

Description

Write docs for how to contribute content and/or code to the Dev Portal

Notes from design jam on April 27: Google doc (restricted access)

Related Objects

StatusSubtypeAssignedTask
ResolvedAklapper
ResolvedAklapper
ResolvedAklapper
ResolvedAklapper
ResolvedNone
ResolvedAklapper
ResolvedAklapper
ResolvedAklapper
ResolvedAklapper
ResolvedNone
Resolvedbd808
Resolvedabi_
Resolvedapaskulin
ResolvedAklapper
ResolvedAklapper
Resolvedbd808
Resolvedbd808
ResolvedSpikebd808

Event Timeline

Regarding content, this might supersede T290254: Workflow how to add/edit content and T276702: Workflow how to propose content changes?

I'd probably add two sections to https://wikitech.wikimedia.org/wiki/Developer_Portal (as https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal is a WMF project page), or maybe a separate subpage.

Should probably be linked from the footer of the Developer Portal if possible, e.g. "Contribute to this website" or such.

Quick wiki markup draft for a one-liner and two-liner:

== Propose content changes ==

Please [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?description=%2F%2FPlease%20fill%20out%20this%20form%20to%20request%20content%20changes%20on%20https%3A%2F%2Fdeveloper.wikimedia.org%20and%20use%20the%20preview%20below!%2F%2F%0D%0A%0D%0A**Only%20if%20you%20propose%20to%20change%20existing%20content%3A**%0D%0A%0D%0A*%20Paste%20the%20current%20content%20(text%20and%20URL)%3A%20%0D%0A%0D%0A*%20Provide%20the%20proposed%20new%20content%20(text%20and%20URL)%3A%0D%0A%0D%0A*%20Provide%20a%20short%20explanation%20why%20you%20are%20proposing%20this%20change%3A%0D%0A%0D%0A**Only%20if%20you%20propose%20to%20add%20new%20content%3A**%0D%0A%0D%0A**%20Provide%20a%20full%20URL%20address%20of%20the%20web%20page%20or%20web%20site%20to%20link%20from%20the%20Developer%20Portal%3A%0D%0A%0D%0A*%20Provide%20a%20short%20text%20that%20describes%20the%20topic%20and%20URL%3A%0D%0A%0D%0A*%20%5BOptional%5D%20Provide%20a%20link%20trail%20where%20in%20the%20Developer%20Portal%20you'd%20expect%20this%20information%20to%20be%20found%3A%0D%0A%0D%0A**%20Provide%20a%20short%20explanation%20why%20you%20are%20proposing%20this%20change%20and%20why%20this%20topic%20and%20URL%20should%20be%20added%20to%20the%20developer%20portal.%20Note%20that%20we%20prefer%20to%20link%20to%20overview%20pages%20for%20a%20specific%20topic%20area%3A%0D%0A%0D%0A%0D%0A---%0D%0A%0D%0AIf%20you%20would%20like%20to%20prepare%20this%20content%20change%20yourself%3A%20Please%20%5Bfollow%20the%20%22Quick%20start%22%20section%5D(https%3A%2F%2Fgerrit.wikimedia.org%2Fg%2Fwikimedia%2Fdeveloper-portal%2F)%20and%20%5Bprovide%20a%20changeset%20in%20a%20Gerrit%20branch%5D(https%3A%2F%2Fwww.mediawiki.org%2Fwiki%2FGerrit%2FTutorial)%20following%20the%20%5Bcommit%20message%20guidelines%5D(https%3A%2F%2Fwww.mediawiki.org%2Fwiki%2FGerrit%2FCommit_message_guidelines).%20Thanks!&projects=wikimedia-developer-portal propose content additions or content changes in a Phabricator task]. ([[mw:Phabricator/Help|Learn more about Phabricator.]])

== Propose code changes ==

Please [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=wikimedia-developer-portal propose your code changes in a Phabricator task]. ([[mw:Phabricator/Help|Learn more about Phabricator.]])

If you would like to prepare a code change yourself: Please [https://gerrit.wikimedia.org/g/wikimedia/developer-portal/ follow the "Quick start" section] and [[mw:Gerrit/Tutorial|provide a changeset in a Gerrit branch]] following the [[mw:Gerrit/Commit message guidelines|commit message guidelines]].
apaskulin triaged this task as Medium priority.Apr 25 2022, 8:27 PM

Change 792582 had a related patch set uploaded (by Aklapper; author: Aklapper):

[wikimedia/developer-portal@main] About: Explicitly link how to contribute code, content, translations

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

Change 792582 merged by jenkins-bot:

[wikimedia/developer-portal@main] About: Explicitly link how to contribute code, content, translations

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