Promote JS!

Better Docs For Us, By Us!

Learn JavaScript JS

Promote Code Made Fresh For You!

Why Promote JS?

JavaScript (JS) is such a widely used language that you would assume the first hit on google for a search like "JavaScript" would yield something of value, right? Well, unfortunately that is not so and in general JS documentation is hard to find through normal search methods, but we don't have to let it be that way!! What if every developer helped to promote the most proper and correct JS documentation? Answer: we could change everything! This is your call to action to help bring down bad documentation and promote proper JS documentation and tutorials!

This will be a long and hard battle, and you will have to write blog posts and articles that link back to documentation that you believe is of high value and quality, but by doing so you are helping change things. For a quick win, help out by copying the provided HTML code above and paste it into your website, your blog, your friend's blog, and be sure to tell your friends why you are doing it - that you believe in better documentation. Also be sure to write a blog post about it AND most importantly link to the documentation for JavaScript String, Function, Array, Object, etc.

What is up with the banner?

This site generates a unique promote code each time you visit, based on metrics and targets, so just refresh if you want to help promote something different or write your own but link it to proper JavaScript documentation. Ideally you place this code into a site that deals with technology, specifically JavaScript, but not required. Then as more people being to link their articles, note this part is key, AND put buttons in, we can change the search results. We are also working to improve the MDN and other such resources as well as pool them together in a more concise manner. This is not something that is a one off item, but a long term commitment for us, by us to improve things.

Or fancy a WordPress plugin?

Alternatively you can install the WordPress (widget compatible) plugin to your blog and it will rotate the different documentation links on your site. Download it now

Feed me!

Maybe you are about to tweet something like: "I hate buttons, I hate wordpress plugin, so why not give me a freakin' data feed that I can use to my own ends!" Ok, ok here it is: and if you want a specific targeted one, use key=(string|function|array|object|regexp|number) as your get parameters. Also, only get requests allowed, all others will be 404'ed.

But how will we know if we have succeeded?

First off success for #promotejs is measured by developers everywhere writing better JavaScript code. A cursory, and easier to track, metric for this will be the placement of targeted documentation in the Search Engine Results page for the targeted keywords. Option one is to check every single keyword every day, but that is crazy. Option two, is to check the trending of keywords over time using: AreWeFirstYet, to which the target answer is yes and we are well on our way!

But I have awesome documentation too!

Excellent, please fork the project add your documentation and send it for review. We are more than happy to have all resources reviewed and curated along with their SEO targeted keywords. This is a community effort, so don't be afraid to roll up your sleeves! Also we will be launching various updates to this campaign, so please check back and see if you can help on those efforts.

If you have any ideas, comments, and/or suggestions about the #promotejs campaign, please either contact Chris Williams (@voodootikigod) or jump into the JSConf chatroom on