DSG: Add deprecation notice
Closed, ResolvedPublic1 Estimated Story Points
Actions

Description

The design style guide will be deprecated in favor of Codex, once all of the desired content is moved over. In the meantime, we should let users of the style guide know that the content is being moved and where they can go moving forward.

Acceptance Criteria

The design style guide has a prominent notice letting users know that content is being moved to Codex and the style guide will eventually redirect there.
Codex has also been added to the Resources page https://github.com/wikimedia/WikimediaUI-Style-Guide/pull/509

NOTE: once all the DSG content has been moved to Codex, we will redirect the DSG to Codex in T347895: Redirect DSG to Codex's Style Guide .

Details

	Subject	Repo	Branch	Lines +/-
	miscweb: update design-style-guide to show deprecation notice	operations/deployment-charts	master	+1 -1

Customize query in gerrit

	Title	Reference	Author	Source Branch	Dest Branch
	Add deprecation notice to all DSG pages (#521)	repos/sre/miscweb/design-style-guide!2	jelto	deprecation-notice-cherry-pick	master

Customize query in GitLab

Related Objects
Search...

Status	Assigned	Task
Resolved	Volker_E	T333144 [EPIC] Migrate DSG resources to Codex
Resolved	Volker_E	T347754 DSG: Add deprecation notice
Resolved	Volker_E	T348712 Fix DSG repository's accumulated repo dependency issues
Resolved	Volker_E	T352202 Final deploy of DSG

Event Timeline

CCiufo-WMF created this task.Sep 29 2023, 6:24 PM

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptSep 29 2023, 6:24 PM

CCiufo-WMF triaged this task as Medium priority.Sep 29 2023, 6:25 PM

CCiufo-WMF added a parent task: T333144: [EPIC] Migrate DSG resources to Codex.

Who is able to actually update the currently-existing DSG site? @Volker_E will coordinate with SRE to see if we can make the necessary changes quickly here.

egardner moved this task from Needs Refinement to Up Next on the Design-System-Team board.Oct 2 2023, 6:54 PM

bmartinezcalvo updated the task description. (Show Details)Oct 3 2023, 8:22 AM

bmartinezcalvo merged a task: T347937: DSG: add banner explaining that it will be moved to Codex.

bmartinezcalvo mentioned this in T333144: [EPIC] Migrate DSG resources to Codex.

bmartinezcalvo added subscribers: bmartinezcalvo, RHo.

bmartinezcalvo mentioned this in T347895: Redirect DSG to Codex's Style Guide .Oct 3 2023, 9:06 AM

egardner assigned this task to Volker_E.Oct 10 2023, 6:03 PM

egardner moved this task from Up Next to Design-Systems-Sprint-10 on the Design-System-Team board.

egardner edited projects, added Design-System-Team (Design-Systems-Sprint-10); removed Design-System-Team.

Volker_E added a project: Documentation.Oct 12 2023, 6:58 AM

Volker_E updated the task description. (Show Details)

CCiufo-WMF closed subtask T348712: Fix DSG repository's accumulated repo dependency issues as Resolved.Oct 23 2023, 1:10 PM

CCiufo-WMF moved this task from Design-Systems-Sprint-10 to Up Next on the Design-System-Team board.Oct 23 2023, 4:41 PM

CCiufo-WMF edited projects, added Design-System-Team; removed Design-System-Team (Design-Systems-Sprint-10).

CCiufo-WMF moved this task from Up Next to Design-Systems-Prep-Week 2023-10 on the Design-System-Team board.Oct 23 2023, 5:16 PM

CCiufo-WMF edited projects, added Design-System-Team (Design-Systems-Prep-Week 2023-10); removed Design-System-Team.

CCiufo-WMF moved this task from Design-Systems-Prep-Week 2023-10 to Up Next on the Design-System-Team board.Oct 30 2023, 4:50 PM

CCiufo-WMF edited projects, added Design-System-Team; removed Design-System-Team (Design-Systems-Prep-Week 2023-10).

CCiufo-WMF set the point value for this task to 1.Oct 30 2023, 5:15 PM

CCiufo-WMF moved this task from Up Next to DST-Sprint-11 (2023-10-30 to 2023-11-22) on the Design-System-Team board.

CCiufo-WMF edited projects, added Design-System-Team (DST-Sprint-11 (2023-10-30 to 2023-11-22)); removed Design-System-Team.

CCiufo-WMF moved this task from Committed to Blocked ⛔ on the Design-System-Team (DST-Sprint-11 (2023-10-30 to 2023-11-22)) board.

Catrope edited projects, added Design-System-Team (DST-Sprint-12 (2023-11-28 to 2023-12-08)); removed Design-System-Team (DST-Sprint-11 (2023-10-30 to 2023-11-22)).Nov 28 2023, 7:01 PM

CCiufo-WMF moved this task from DST-Sprint-12 (2023-11-28 to 2023-12-08) to Up Next on the Design-System-Team board.Dec 11 2023, 6:05 PM

CCiufo-WMF edited projects, added Design-System-Team; removed Design-System-Team (DST-Sprint-12 (2023-11-28 to 2023-12-08)).

CCiufo-WMF moved this task from Up Next to DST-Sprint-13 (2023-12-11 to 2023-12-22) on the Design-System-Team board.Dec 11 2023, 6:39 PM

CCiufo-WMF edited projects, added Design-System-Team (DST-Sprint-13 (2023-12-11 to 2023-12-22)); removed Design-System-Team.

CCiufo-WMF moved this task from Committed to Blocked ⛔ on the Design-System-Team (DST-Sprint-13 (2023-12-11 to 2023-12-22)) board.Dec 11 2023, 7:00 PM

Volker_E moved this task from Backlog to Next for Development on the Wikimedia Design Style Guide board.Dec 20 2023, 7:48 PM

AnneT moved this task from DST-Sprint-13 (2023-12-11 to 2023-12-22) to Up Next on the Design-System-Team board.Jan 8 2024, 5:41 PM

AnneT edited projects, added Design-System-Team; removed Design-System-Team (DST-Sprint-13 (2023-12-11 to 2023-12-22)).

AnneT moved this task from Up Next to DST-Sprint-14 (2024-01-08 to 2024-01-19) on the Design-System-Team board.Jan 8 2024, 6:33 PM

AnneT edited projects, added Design-System-Team (DST-Sprint-14 (2024-01-08 to 2024-01-19)); removed Design-System-Team.

I saw the patch in the mail and learned about it being deprecated. I wanted to suggest making not a standard notification, but a notification with a link to the corresponding page in the Codex page (section), because I have now spent a lot of time finding information on colors :)

For example in https://design.wikimedia.org/style-guide/visual-style_colors.html:
Wikimedia Design Style Guide will be archived soon. Visit its improved and enhanced successor:<br><a href="https://doc.wikimedia.org/codex/latest/design-tokens/color.html" target="_blank">Codex, Design System for Wikimedia</a>.

Wikimedia Design Style Guide will be archived soon. Visit its improved and enhanced successor:<br><a href="https://doc.wikimedia.org/codex/latest/design-tokens/" target="_blank">Codex, Design System for Wikimedia</a>.

@Iniquity We are planning to do per-page redirects when we finally remove design.wikimedia.org/style-guide – for this change it seemed as wrongly spent time given our current workload. The deprecation (before archiving completely) should only be there for a few weeks.

Patch was provided at https://github.com/wikimedia/WikimediaUI-Style-Guide/pull/521 and is merged.

Volker_E moved this task from Committed to Pending Release on the Design-System-Team (DST-Sprint-14 (2024-01-08 to 2024-01-19)) board.Jan 18 2024, 8:06 PM

In T347754#9470669, @Volker_E wrote:

@Iniquity We are planning to do per-page redirects when we finally remove design.wikimedia.org/style-guide – for this change it seemed as wrongly spent time given our current workload. The deprecation (before archiving completely) should only be there for a few weeks.

Oh, great! Thank you :)

jelto opened https://gitlab.wikimedia.org/repos/sre/miscweb/design-style-guide/-/merge_requests/2

Add deprecation notice to all DSG pages (#521)

jelto merged https://gitlab.wikimedia.org/repos/sre/miscweb/design-style-guide/-/merge_requests/2

Add deprecation notice to all DSG pages (#521)

Change 991748 had a related patch set uploaded (by Jelto; author: Jelto):

[operations/deployment-charts@master] miscweb: update design-style-guide to show deprecation notice

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

Change 991748 merged by jenkins-bot:

[operations/deployment-charts@master] miscweb: update design-style-guide to show deprecation notice

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

The deprecation notice is deployed on https://design.wikimedia.org/style-guide/, see T352202#9472494.

Excellent, thanks @Jelto!

Volker_E updated the task description. (Show Details)Jan 19 2024, 2:05 PM

Volker_E removed a project: Patch-For-Review.

Looks great!

DSG: Add deprecation noticeClosed, ResolvedPublic1 Estimated Story PointsActions