Improves homepage, FAQ to better describe the project

[snostorm]

There is a lot of feedback today that our website copy is doing a bad job of explaining to outsiders what io.js actually is.

This is to track some PRs relating to doing a better job of explaining this, sooner than later, as we have a lot of traffic right now.

• Add a link to this repo for people to help with content, spelling, etc. Link people to this repo for website issues somehow #55 (blocked by Renames project to iojs.org (or, simply, website?) #57?)
• Home page: better "blurb", explain 1.0.x semver Add more information to the homepage to explain what io.js is. #50
• FAQ: improve "what is io.js" Updates FAQ to expand “What is io.js”, adds semver section #53 #54
• FAQ: adds info about semver Updates FAQ to expand “What is io.js”, adds semver section #53 #54
• FAQ: link to projects, tools which use/support io.js ? - could be premature. Collecting in Wiki
  • heroku
  • Atom editor
  • n, nvm (soon)

[mikeal]

I'm going to take a lot of that feedback with a grain of salt. It's written by people who actually are familiar with the project describing what they think people who aren't familiar think about it. If you read it carefully you can tell that they are imposing their own ideas about the project on to the messaging which is what confuses them.

The messaging is intended for developers who are slightly familiar with JavaScript and the ecosystem (probably have heard of npm but not io.js). And also for the press and outside commenters to get an idea of what people can use it for.

[mikeal]

Add a link to this repo for people to help with content, spelling, etc.

You mean other than the "io.js" link in the topline messaging?

[mikeal]

Home page: better "blurb", explain 1.0.x semver #50

Topline messaging should not include anything about semver. It's great that we've moved to it, I'm stoked, but it's very "inside baseball." This should probably be in the FAQ though, along with an explanation about how the version numbers line up with expectations on stability.

[mikeal]

Atom editor

Atom is already on io.sj?!?!?!

[snostorm]

@mikeal

Add a link to this repo for people to help with content, spelling, etc.

You mean other than the "io.js" link in the topline messaging?

Yes, @Fishrock123 just opened #54 on this. A "help improve this page" type link, especially on FAQ, ES6 (and future article-pages.)

[snostorm]

Home page: better "blurb", explain 1.0.x semver #50

Topline messaging should not include anything about semver. It's great that we've moved to it, I'm stoked, but it's very "inside baseball." This should probably be in the FAQ though, along with an explanation about how the version numbers line up with expectations on stability.

Now that the FAQ RP #54 contains a semver description, we can probably move it out of the homepage box or just say somewhere near the version something like "io.js now uses semver, read more"

[mikeal]

A "help improve this page" type link

Oh I see! Link them to this repo, not to the io.js repo :) Yes, very nice :)