1311276 - Macro cleanup

Status: RESOLVED WONTFIX

(Developer Documentation Graveyard :: Macros/Templates, defect)

Description

[Sebastian Zartner [:sebo]]

Attachment: Macro usage information

Florian started a project for improving MDN macros by moving to GitHub back in 2015.[1] Part of this project is to clean up and consolidate the existing list of macros.[2] This bug is meant to track the cleanup progress.

There's already a list of all templates, their usage numbers in pages and related notes.[3] In addition to that I've created a script, which generates a more detailed report about macro usage numbers.[4] A current report is attached.

Sebastian

[1] https://groups.google.com/d/topic/mozilla.dev.mdc/rPT8vgZdJBk/discussion
[2] https://docs.google.com/presentation/d/1RE4qi047mFAwBChKMg-4CUSe23jFZmRDMbmCX867Bio/edit#slide=id.ge61d748be_0_37
[3] https://docs.google.com/spreadsheets/d/1D096ODJGuAYOw03zWsnpy4o10Ci_JRynmyA3m36cmzw/edit#gid=1457613375
[4] https://github.com/SebastianZ/templateScraper/

Comment 1

[Florian Scholz (Open Web Docs)]

There is a new usage dashboard https://developer.mozilla.org/en-US/dashboards/macros

In the 2017 Austin work week, we've purged 162 macros
https://mozilla.github.io/meao/2018/01/08/kuma-report/#macro-massacre-dec-17

Comment 2

[Sebastian Zartner [:sebo]]

I see there are 331 macros left. I assume all the XUL and XBL related ones can go away now or at least soon.
I'm not up-to-date on what's the plan here and the spreadsheet linked to above seems to be outdated. So what's still missing here?

Sebastian

Comment 3

[Florian Scholz (Open Web Docs)]

Please see https://discourse.mozilla.org/t/next-steps-for-kumascript/32227
tl;dr: We might kill KumaScript altogether, as we think there is a lot of misconceptions and garbage in the remaining macros.

XUL and XBL archiving is related but is a project on its own. We haven't made a plan for that yet.

Comment 4

[BMO Automation]

MDN Web Docs' bug reporting has now moved to GitHub. From now on, please file content bugs at https://github.com/mdn/sprints/issues/ and platform bugs at https://github.com/mdn/kuma/issues/.