Page MenuHomePhabricator
Create Task
Maniphest T308236

Add "Wikimedia Developer Portal" to translatewiki.net
Closed, ResolvedPublic2 Estimated Story Points
Actions

Description

Project information

Name: Wikimedia Developer Portal (or wikimedia-developer-portal?)
Homepage: https://developer.wikimedia.org/ once live (see T297140: New Service Request: developer-portal); current testing instance at https://developer-portal.wmcloud.org/
Project link: https://wikitech.wikimedia.org/wiki/Developer_Portal
Code repository: https://gerrit.wikimedia.org/g/wikimedia/developer-portal/

  • Source branch: main
  • Target branch: main

OS License: Code and configuration: GNU GPLv3+ license. Textual content: CC-BY-SA 3.0 license.
Issue Tracker: https://phabricator.wikimedia.org/tag/wikimedia-developer-portal/
Project contact: AKlapper user account on Translatewiki.net
File format: PO

Logo:

Project description:
A single entry point to find Wikimedia technical documentation, and connect with the developer community behind Wikimedia projects.

PO files are expected to be stored as data/locale/${LANGUAGE_CODE}/LC_MESSAGES/mkdocs.po within the repository.

Translation units are extracted from Markdown source files using a custom mkdocs plugin in a process similar to a Django project's workflow. We expect to write help docs on our TWN project page explaining the markdown syntax that translators will need to preserve when localizing our messages.

NOTE: Section below will be filled by twn staff

Project setup checklist

Project configuration (for translation admins)

Namespace: NS_WIKIMEDIA
Prefix: wikimedia-developer-portal-
Validators: None
Insertables:

  1. RegexInsertablesSuggester - !?\[.+\]\(.+\)
  2. UrlInsertablesSuggester

Support:

Concerns

Details

ProjectBranchLines +/-Subject
translatewikimaster+1 -0WikimediaDeveloperPortal: Enable auto-merge
integration/configmaster+2 -0developer-portal: add gate-and-submit-l10n for L10n-bot
translatewikimaster+26 -2WikimediaDeveloperPortal: Improve markdown link and email insertable
translatewikimaster+1 -0WikimediaDeveloperPortal: Add definitionFile
wikimedia/developer-portalmain+34 -0Mark English PO catalog as fuzzy
translatewikimaster+1 -1WikimediaDeveloperPortal: Fix sourcePattern
translatewikimaster+39 -0Add Wikimedia Developer Portal
wikimedia/developer-portalmain+0 -2 KRemove "fake" translations used during development
wikimedia/developer-portalrefs/meta/config+10 -0Add permissions for TWN integration and release tagging
Customize query in gerrit

Related Objects
Search...

StatusSubtypeAssignedTask
 ResolvedAklapperT265018 Update redirect target of dev.wikimedia.org to Developer Portal
 ResolvedAklapperT265019 Update several on-wiki link targets for "Developers" links (sidebars, footer, pages)
 ResolvedAklapperT286568 Communicate launch
 ResolvedAklapperT302809 Add dev portal to list of microsites on doc.wikimedia.org
 OpenNoneT299923 Update Zulip's welcomebot message and GSoC organization contact to point to dev portal
 ResolvedAklapperT287030 Update or remove meta:Wikimedia_Resource_Center/For_developers
 ResolvedAklapperT265017 Once developer.wikimedia.org is up, make https://www.mediawiki.org/wiki/API:Web_APIs_hub redirect to it
 ResolvedAklapperT261510 Launch MVP of Developer Portal on https://developer.wikimedia.org/
 ResolvedAklapperT306832 Create documentation for contributors
 ResolvedAklapperT290254 Workflow how to add/edit content
 ResolvedAklapperT276702 Workflow how to propose content changes
 ResolvedAklapperT303987 Create documentation for translators
 ResolvedNoneT290256 Workflow for translators how to translate content
 Resolvedbd808T276700 Content localization infrastructure setup (export, import, deploy)
 Resolvedbd808T276708 Define content storage format (levels, data structure, hierarchy, categorization, etc)
 ResolvedBUG REPORTbd808T309113 Static pages fail to build when the active locale is not also supported by mkdocs-material theme
 Resolvedabi_T308236 Add "Wikimedia Developer Portal" to translatewiki.net
 Resolvedbd808T297168 Write localization/internationalization mkdocs plugin
 ResolvedSpikebd808T295832 Evaluate improving/replacing mkdocs-mdpo-plugin to better support TWN integration
 ResolvedapaskulinT287501 Check RTL support on the developer portal

Event Timeline

Aklapper changed the task status from Open to Stalled.May 12 2022, 12:08 PM
Aklapper created this task.
Aklapper updated the task description. (Show Details)
Aklapper added a subtask: T297168: Write localization/internationalization mkdocs plugin.
Aklapper added a parent task: T290256: Workflow for translators how to translate content.
Aklapper updated the task description. (Show Details)May 12 2022, 12:14 PM
Aklapper moved this task from Inbox to Launch on the Wikimedia-Developer-Portal board.
Base added a subscriber: Base.May 12 2022, 12:40 PM
abi_ awarded a token.May 12 2022, 12:55 PM
gerritbot added a comment.May 12 2022, 2:27 PM

Change 791257 had a related patch set uploaded (by BryanDavis; author: BryanDavis):

[wikimedia/developer-portal@refs/meta/config] Add permissions for TWN integration and release tagging

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

gerritbot added a project: Patch-For-Review.May 12 2022, 2:27 PM

Change 791257 merged by BryanDavis:

[wikimedia/developer-portal@refs/meta/config] Add permissions for TWN integration and release tagging

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

Maintenance_bot removed a project: Patch-For-Review.May 12 2022, 2:30 PM
Aklapper added a comment.May 12 2022, 2:38 PM

As per Bryan we should probably remove some test (machine) translations we are using (e.g. for RTL testing in T287501) at some point. Afterwards, this should be ready to go

Aklapper added a subtask: T287501: Check RTL support on the developer portal.May 12 2022, 2:38 PM
gerritbot added a comment.May 12 2022, 2:39 PM

Change 791386 had a related patch set uploaded (by BryanDavis; author: Bryan Davis):

[wikimedia/developer-portal@main] Remove "fake" translations used during development

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

gerritbot added a project: Patch-For-Review.May 12 2022, 2:39 PM
gerritbot added a comment.May 12 2022, 2:52 PM

Change 791386 merged by jenkins-bot:

[wikimedia/developer-portal@main] Remove "fake" translations used during development

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

bd808 mentioned this in rWDPOaf828573fbcc: Remove "fake" translations used during development.May 12 2022, 2:52 PM
bd808 changed the task status from Stalled to Open.May 12 2022, 2:58 PM
bd808 removed a project: Patch-For-Review.
bd808 updated the task description. (Show Details)
bd808 updated the task description. (Show Details)
Base mentioned this in T308252: Clarify source and content license terms on website (not just in git repo README).May 12 2022, 3:11 PM
Nikerabbit moved this task from Backlog to New projects for translation on the translatewiki.net board.May 12 2022, 3:29 PM
gerritbot added a comment.May 16 2022, 11:43 AM

Change 792180 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[translatewiki@master] Add Wikimedia Developer Portal

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

gerritbot added a project: Patch-For-Review.May 16 2022, 11:43 AM
abi_ changed the task status from Open to In Progress.May 16 2022, 11:44 AM
abi_ claimed this task.
abi_ triaged this task as Medium priority.
abi_ added a project: Language-Team (Language-2022-April-June).
abi_ moved this task from Quarter Backlog to In Review on the Language-Team (Language-2022-April-June) board.
abi_ updated the task description. (Show Details)
gerritbot added a comment.May 17 2022, 9:22 AM

Change 792180 merged by jenkins-bot:

[translatewiki@master] Add Wikimedia Developer Portal

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

Maintenance_bot removed a project: Patch-For-Review.May 17 2022, 9:30 AM
gerritbot added a comment.May 17 2022, 10:35 AM

Change 792578 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[translatewiki@master] WikimediaDeveloperPortal: Fix sourcePattern

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

gerritbot added a project: Patch-For-Review.May 17 2022, 10:35 AM
gerritbot added a comment.May 17 2022, 10:40 AM

Change 792578 merged by jenkins-bot:

[translatewiki@master] WikimediaDeveloperPortal: Fix sourcePattern

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

abi_ added a subscriber: bd808.May 17 2022, 11:03 AM

@bd808 - Since we don't have a pot file, translatewiki expects a fuzzy tag in the header. Something similar to this: https://gerrit.wikimedia.org/r/plugins/gitiles/wikimedia/toolhub/+/refs/heads/main/toolhub/locale/en/LC_MESSAGES/django.po#6

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy <--------------------
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-09 00:51+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
abi_ updated the task description. (Show Details)May 17 2022, 11:23 AM
Maintenance_bot removed a project: Patch-For-Review.May 17 2022, 11:30 AM
Aklapper added a parent task: T303987: Create documentation for translators.May 17 2022, 6:32 PM
gerritbot added a comment.May 17 2022, 9:43 PM

Change 792725 had a related patch set uploaded (by BryanDavis; author: Bryan Davis):

[wikimedia/developer-portal@main] Mark English PO catalog as fuzzy

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

gerritbot added a project: Patch-For-Review.May 17 2022, 9:43 PM
gerritbot added a comment.May 17 2022, 10:08 PM

Change 792725 merged by jenkins-bot:

[wikimedia/developer-portal@main] Mark English PO catalog as fuzzy

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

bd808 mentioned this in rWDPO4331d5562fee: Mark English PO catalog as fuzzy.May 17 2022, 10:08 PM
bd808 added a comment.May 17 2022, 10:20 PM
In T308236#7934069, @abi_ wrote:

@bd808 - Since we don't have a pot file, translatewiki expects a fuzzy tag in the header.

We had the code to do this, but apparently I had not rebuilt the English catalog completely since adding the fuzzy tag to the initialization code. Our data/locale/en/LC_MESSAGES/mkdocs.po hopefully has all of the needed metadata now.

Maintenance_bot removed a project: Patch-For-Review.May 17 2022, 10:30 PM
Aklapper mentioned this in T290256: Workflow for translators how to translate content.May 18 2022, 6:44 AM
Aklapper added a comment.May 18 2022, 6:53 AM

Looks like this task is pretty much resolved (thanks)?; Separate T308633 covers issues with parsing strings themselves.

gerritbot added a comment.May 18 2022, 9:14 AM

Change 792994 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[translatewiki@master] WikimediaDeveloperPortal: Add definitionFile

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

gerritbot added a project: Patch-For-Review.May 18 2022, 9:14 AM

Change 792995 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[translatewiki@master] WikimediaDeveloperPortal: Improve markdown link and email insertable

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

abi_ updated the task description. (Show Details)May 18 2022, 9:28 AM
gerritbot added a comment.May 18 2022, 10:30 AM

Change 792994 abandoned by Abijeet Patro:

[translatewiki@master] WikimediaDeveloperPortal: Add definitionFile

Reason:

not needed

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

abi_ moved this task from In Review to Recheck after deployment on the Language-Team (Language-2022-April-June) board.May 18 2022, 10:39 AM
In T308236#7937107, @Aklapper wrote:

Looks like this task is pretty much resolved (thanks)?; Separate T308633 covers issues with parsing strings themselves.

We generally leave the tasks open until translations are exported out of translatewiki to the project repository. This should happen tomorrow.

abi_ set the point value for this task to 2.May 19 2022, 8:28 AM
gerritbot added a comment.May 19 2022, 9:10 AM

Change 792995 abandoned by Abijeet Patro:

[translatewiki@master] WikimediaDeveloperPortal: Improve markdown link and email insertable

Reason:

In favor of: Ib5dbe9b0c6d604bd699168560b1ef3a4ab6f2d18

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

Nikerabbit added a subscriber: Nikerabbit.May 19 2022, 12:00 PM

First export: https://gerrit.wikimedia.org/r/c/wikimedia/developer-portal/+/793437

abi_ added a comment.May 19 2022, 2:12 PM

Need to configure: https://www.mediawiki.org/wiki/Gerrit/L10n-bot

gerritbot added a comment.May 19 2022, 5:48 PM

Change 793527 had a related patch set uploaded (by BryanDavis; author: Bryan Davis):

[integration/config@master] developer-portal: add gate-and-submit-l10n for L10n-bot

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

gerritbot added a comment.May 19 2022, 5:54 PM

Change 793528 had a related patch set uploaded (by BryanDavis; author: Bryan Davis):

[translatewiki@master] WikimediaDeveloperPortal: Enable auto-merge

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

gerritbot added a comment.May 19 2022, 7:33 PM

Change 793527 merged by jenkins-bot:

[integration/config@master] developer-portal: add gate-and-submit-l10n for L10n-bot

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

gerritbot added a comment.May 23 2022, 4:28 AM

Change 793528 merged by jenkins-bot:

[translatewiki@master] WikimediaDeveloperPortal: Enable auto-merge

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

abi_ closed this task as Resolved.May 23 2022, 12:30 PM
abi_ moved this task from Recheck after deployment to Done on the Language-Team (Language-2022-April-June) board.
In T308236#7941817, @abi_ wrote:

Need to configure: https://www.mediawiki.org/wiki/Gerrit/L10n-bot

Thanks @bd808 for making the necessary changes. Export from translatewiki was merged automatically: 797185: Localisation updates from https://translatewiki.net. | https://gerrit.wikimedia.org/r/c/wikimedia/developer-portal/+/797185

abi_ updated the task description. (Show Details)May 23 2022, 12:31 PM
bd808 added a parent task: T309113: Static pages fail to build when the active locale is not also supported by mkdocs-material theme.May 24 2022, 3:43 PM
apaskulin closed subtask T287501: Check RTL support on the developer portal as Resolved.May 25 2022, 6:05 PM
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