1414088 - Glossary entry for Symbol too detailed; move it into the JavaScript Guide, which doesn't say much

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: JavaScript, enhancement, P1)

Description

[Eric Shepherd [:sheppy]]

The Glossary entry on Symbol is currently much, much longer than typical Glossary entries, and the JavaScript Guide spends exactly one paragraph on Symbol[2] -- with nowhere near enough detail for someone new to this information to make much sense of it.

I suggest we move the majority of the glossary entry into the JS Guide, with some modest cleaning up, and reduce the Glossary entry down to a brief explanation.

[1] https://developer.mozilla.org/en-US/docs/Glossary/Symbol

[2] https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Symbol_type

Comment 1

[Florian Scholz (Open Web Docs)]

I've shortened the glossary page: https://developer.mozilla.org/en-US/docs/Glossary/Symbol
It was in fact talking about a lot of things that we also cover elsewhere (mostly in the Symbol reference)

I left in the sections about well-known symbols and global symbol registry as I thought these sub terms could be explained briefly here as well, so that the reader can glance over these sub concepts of symbol quickly. Let me know what you think.

review sheppy?

Comment 2

[Eric Shepherd [:sheppy]]

r+