I've noticed our MDN pages climbing in search results over the last year or so, which is great to see. If we do fold pages like these together we should be carful to keep the pages that rank higher in search results.

http://www.bing.com/search?form=MOZPSB&pc=MOZO&q=javascript+string+object

https://www.google.com/search?q=javascript+string+object&ie=utf-8&oe=utf-8&aq=t&rls=org.mozilla:en-US:unofficial&client=firefox-nightly

both have this url in the top three:

https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/String

Jim


-----Original Message----- From: Eric Shepherd Sent: Monday, April 22, 2013 2:04 PM Newsgroups: mozilla.dev.mdc,mozilla.dev.platform
To: dev-platform@lists.mozilla.org
Subject: JavaScript reference changes: looking for opinions

Currently, the JavaScript reference content for the global classes
(String, Array, etc), are divided up such that the class methods and
properties and the prototype methods and properties are documented
separately, with links between them. For example, see:

https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/String


and

https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/String/prototype


While this might make sense to super-expert JavaScript folks (indeed,
it was their idea to do it this way), it's actually really confusing to
everyone else.

I'd like to propose we merge them back together, so that the stuff
currently documented on the "prototype" page is in the main body of the
class's documentation where most people would expect it to be. If
useful, we can come up with a badge to put next to items that are part
of the prototype (or not) to differentiate between them.

But the current organization is, well, kind of weird.

Any opinions on this pro or con before we actually try to find someone
to do the work?

--
Eric Shepherd
Developer Documentation Lead
Mozilla
Blog: http://www.bitstampede.com/
Twitter: @sheppy

_______________________________________________
dev-platform mailing list
dev-platform@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-platform
_______________________________________________
dev-platform mailing list
dev-platform@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-platform

Reply via email to