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)
Description
Description
Details
Details
| Project | Branch | Lines +/- | Subject | |
|---|---|---|---|---|
| wikimedia/developer-portal | main | +14 -6 | About: Explicitly link how to contribute code, content, translations |
Event Timeline
Comment Actions
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]].
Comment Actions
I created https://wikitech.wikimedia.org/wiki/Developer_Portal#Contribute in https://wikitech.wikimedia.org/w/index.php?title=Developer_Portal&type=revision&diff=1980541&oldid=1968022 which still has a TODO for the translation part. (wikitech because https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal is only a project page of some WMF team and that project will have an end date.)
IMHO left TODO:
- I'd expand https://developer-portal.wmcloud.org/get-help/about/ to link to https://wikitech.wikimedia.org/wiki/Developer_Portal#Contribute
- Cover the translation aspects (see T308236, T290256: Workflow for translators how to translate content, T303987: Create documentation for translators) on https://wikitech.wikimedia.org/wiki/Developer_Portal#Contribute
- Be explicit on https://www.mediawiki.org/wiki/Developer_Advocacy/Developer_Portal that for content changes, people should check https://wikitech.wikimedia.org/wiki/Developer_Portal#Contribute instead.
Comment Actions
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
Comment Actions
Change 792582 merged by jenkins-bot:
[wikimedia/developer-portal@main] About: Explicitly link how to contribute code, content, translations
Comment Actions
- Cover the translation aspects on https://wikitech.wikimedia.org/wiki/Developer_Portal#Contribute (done already a few days ago)
- Tricia and Quiddity added on project page in https://www.mediawiki.org/w/index.php?title=Developer_Advocacy%2FDeveloper_Portal&type=revision&diff=5224427&oldid=5214434 how to contribute
- Resolve T303987: Create documentation for translators