Page MenuHomePhabricator

Proposal: Add recruitment announcement bar to home page
Closed, ResolvedPublic

Assigned To
Authored By
Sarai-WMF
Jul 15 2026, 7:07 PM
Referenced Files
F95614643: Screenshot 2026-07-24 at 14.31.32.png
Jul 24 2026, 12:33 PM
F93987767: image.png
Jul 16 2026, 12:00 PM
F93987739: image.png
Jul 16 2026, 12:00 PM
F93977882: image.png
Jul 16 2026, 11:42 AM
F93847195: image.png
Jul 15 2026, 7:08 PM
F93846035: image.png
Jul 15 2026, 7:07 PM

Description

Description

A task force team has been working on a new iteration of Wikimedia's Developer Portal (see draft project page). We're planning to conduct a round of usability testing with prospective users of the platform and that, of course, includes anyone accessing the portal today to locate documentation.

We'd like to suggest adding a temporary banner to the Developer portal site as soon as possible to support recruiting technical volunteers for research projects and the v2 exploration in particular, which is planned for the current month (July 2026).

Proposed solution

Quickly checking Material for MkDocs' documentation, it looks like announcement bar (with a dismiss button) would be the exact component we need to display the call-to-action banner.

Here's a mock-up for reference (check in Figma):

light modedark mode
image.png (3,864×1,438 px, 296 KB)
image.png (3,878×1,438 px, 308 KB)

Notes:

  • Copy used is a suggestion: Any feedback on how to improve clarity or directness will be really welcome.
  • Duration: Keeping the banner/announcement bar up for a couple of weeks would be ideal to increase our chances of getting sign-ups without annoying recurrent visitors.

Event Timeline

Thanks for opening this! What is your target date for having this live?

Thanks for opening this! What is your target date for having this live?

I know the description is very imprecise, but "as soon as possible" is the reality. If the banner could be added in by the next reasonable deploy date (Thursday next week?) that would be fantastic

Sounds good, @Sarai-WMF! We'll do our best to get this out ASAP. Would you be willing to open a patch for this? That would be the fastest path forward. In the meantime, I'll think about some copy suggestions.

The assumption is that Codex classes can be used to style the native component, but if that's not the case, I can provide all needed CSS values.

I don't believe we have access to Codex within the site.

Would you be willing to open a patch for this? That would be the fastest path forward. In the meantime, I'll think about some copy suggestions.

I can try. I have 0 experience pushing changes to Gerrit, but will try to follow the Dev portal contribution docs and let you know if I hit any blockers.

Change #1311456 had a related patch set uploaded (by KBach; author: KBach):

[wikimedia/developer-portal@main] Add announcement banner

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

apaskulin moved this task from Inbox to Content & design on the Wikimedia-Developer-Portal board.

Change #1311456 merged by jenkins-bot:

[wikimedia/developer-portal@main] Add announcement banner

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

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

[operations/deployment-charts@master] developer-portal: Bump container to 2026-07-20-124104-production

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

Change #1314888 merged by jenkins-bot:

[operations/deployment-charts@master] developer-portal: Bump container to 2026-07-20-124104-production

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

Hey @apaskulin and @KBach. Thank you so much for your help getting the announcement banner up! I noticed that the “Sign up to participate” button isn't working on production (the behavior was fine when we tested the patch locally!). The browser console indicates that we need to set the 'allow-popups' permission for the element:

Screenshot 2026-07-24 at 14.31.32.png (1,356×146 px, 55 KB)

Had you encountered this issue before? Thanks again for your support!

Change #1315893 had a related patch set uploaded (by KBach; author: KBach):

[wikimedia/developer-portal@main] Add allow-popups to production CSP

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

Change #1315893 merged by jenkins-bot:

[wikimedia/developer-portal@main] Add allow-popups to production CSP

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

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

[operations/deployment-charts@master] developer-portal: Bump container to 2026-07-24-161534-production

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

Change #1315964 merged by jenkins-bot:

[operations/deployment-charts@master] developer-portal: Bump container to 2026-07-24-161534-production

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

Had you encountered this issue before? Thanks again for your support!

The CSP policy is only in prod right now. Alex made T433106: Add allow-popups to content security policy on demo site for us to track getting the demo site setup to test that part somehow.

Re-opening since we're ready to remove the banner

Change #1326855 had a related patch set uploaded (by Alex Paskulin; author: Alex Paskulin):

[wikimedia/developer-portal@main] theme: Remove announcement banner

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

Change #1326855 merged by jenkins-bot:

[wikimedia/developer-portal@main] theme: Remove announcement banner

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

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

[operations/deployment-charts@master] developer-portal: Bump container to 2026-08-20-122835-production

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

Change #1327594 merged by jenkins-bot:

[operations/deployment-charts@master] developer-portal: Bump container to 2026-08-20-122835-production

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

Resolving since the banner is now removed in production