1496661 - MDN documentation on "Adding a new CSS property" describes old style system, not Stylo

Status: RESOLVED WONTFIX

(Developer Documentation Graveyard :: Mozilla Platform, enhancement, P5)

Description

[Mats Palmgren (inactive)]

This documentation is out-dated:
https://developer.mozilla.org/en-US/docs/Mozilla/Adding_a_new_style_property

Perhaps there already is corresponding Stylo documentation somewhere
else so that we can simply replace this page with a link?

Comment 1

[Chris Mills [:cmills]]

There's nothing more up-to-date on MDN to my knowledge, and we are unlikely to update this anytime soon.

Should we just delete it/redirect to say

https://wiki.mozilla.org/Quantum/Stylo

or

https://github.com/servo/servo/wiki/Stylo-hacking-guide

?

Comment 2

[Emilio Cobos Álvarez (:emilio)]

That's probably pretty out of date as well, same for layout/doc/adding-style-props.html... I should probably spend some time writing something.

Comment 3

[Chris Mills [:cmills]]

(In reply to Emilio Cobos Álvarez (:emilio) from comment #2)
> That's probably pretty out of date as well, same for
> layout/doc/adding-style-props.html... I should probably spend some time
> writing something.

I'd be happy to edit it if you did ;-)

Comment 4

[Janet Swisher]

The MDN team is no longer actively working on Mozilla Platform docs. Volunteer contributions are welcome.

Comment 5

[Mats Palmgren (inactive)]

If no-one is actively maintaining these documents shouldn't we at least move them from MDN to some archival site, or add a big scary WARNING box saying that page contents is likely obsolete?

I'm asking because I was about to report a bug about our XUL documentation which is most definitely obsolete (we're actively removing XUL support in Gecko). The mere existence of these pages are misleading people if they think it's something that they can use in Firefox / add-ons etc. It might also poison search results etc (i.e. people might find "XUL <grid>" instead of CSS grid etc). But it appears I can't even report a bug in Bugzilla about issues like this anymore. So I wondering what is our plan for sun-setting this corpus of information? It seems really bad to just leave it as is in its current state.

Comment 6

[Mats Palmgren (inactive)]

(There's plenty of obsolete stuff listed here, BTW. With no indication of their current status.)

Comment 7

[Janet Swisher]

Chris Mills is working with internal dev teams on migrating and setting up maintenance processes for docs related to their work that are currently on MDN, but are not web-standards. https://firefox-source-docs.mozilla.org or something like it might be a solution -- especially now that removing code removes the related docs. Or just delete the XUL docs outright, and anyone who really wants to know about them could use the Wayback Machine.

Comment 8

[Chris Mills [:cmills]]

Our plan is to eventually move all the non-web platform docs off MDN, into GitHub repos somewhere, so we no longer have to worry about them, and the content is still available if people really want to access it. But this is not going to happen any time soon, as we've got so many other things going on.

For now, shall I just move the obsolete stuff into the MDN archive: https://developer.mozilla.org/en-US/docs/Archive ?

This gives more of a signal that it isn't current material and might be out of date.

If you could give me a list of things I can definitely move, I can action that.

Comment 9

[Mats Palmgren (inactive)]

Great. Thanks for working on that.

For now, shall I just move the obsolete stuff into the MDN archive: https://developer.mozilla.org/en-US/docs/Archive ?

Yeah, that would help. We can definitely move XUL and XBL docs there.
https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XBL
https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL

Comment 10

[Chris Mills [:cmills]]

(In reply to Mats Palmgren (:mats) from comment #9)

Great. Thanks for working on that.

For now, shall I just move the obsolete stuff into the MDN archive: https://developer.mozilla.org/en-US/docs/Archive ?

Yeah, that would help. We can definitely move XUL and XBL docs there.
https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XBL
https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL

OK, moved to

• https://developer.mozilla.org/en-US/docs/Archive/Mozilla/XUL
• https://developer.mozilla.org/en-US/docs/Archive/Mozilla/XBL

Along with all their translations.

Comment 11

[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/.