search

mdn / pab

MDN Web Docs Product Advisory Board
26 stars 17 forks source link

Shared style guide for code examples between specs and documentation #21

Closed dontcallmedom closed 5 years ago

dontcallmedom commented 6 years ago

I think it would be useful if it was possible to develop and maintain a shared style guide for code examples included in specs and MDN articles. It would facilitates copy & pasting examples from one to the other, and in general, would help the set of people that are readers and/or writers across the two domain.

W3C doesn't have at the moment a style guide for JavaScript (that I know of); I assume (but I'm not sure) that the CSS Working Group has one for their CSS examples. I don't think there is one for markup either.

I'm not sure if MDN has already style guides for these various languages, and if there are, if there are opportunities for updating them if this was needed for convergence.

chrisdavidmills commented 6 years ago

I think https://github.com/mdn/pab/issues/22 covers this also?

chrisdavidmills commented 5 years ago

Closing.