This repository was archived by the owner on Nov 21, 2018. It is now read-only.
Repository navigation
This repository was archived by the owner on Nov 21, 2018. It is now read-only.
Improves homepage, FAQ to better describe the project #53
Description
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)
Activity
Updates FAQ to expand “What is io.js”, adds semver section #53
mikeal commentedon Jan 14, 2015
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 commentedon Jan 14, 2015
You mean other than the "io.js" link in the topline messaging?
mikeal commentedon Jan 14, 2015
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 commentedon Jan 14, 2015
Atom is already on io.sj?!?!?!
[-]Improves homepage, README to better describe the project[/-][+]Improves homepage, FAQ to better describe the project[/+]snostorm commentedon Jan 14, 2015
@mikeal
Yes, @Fishrock123 just opened #54 on this. A "help improve this page" type link, especially on FAQ, ES6 (and future article-pages.)
snostorm commentedon Jan 14, 2015
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 commentedon Jan 14, 2015
Oh I see! Link them to this repo, not to the io.js repo :) Yes, very nice :)
Updates FAQ to expand “What is io.js”, adds semver section #53
Merge pull request #54 from iojs/53_improves_readme
homepage: switch to “unstable”, link changelog #53
Merge pull request #56 from iojs/53_homepage_changelog_unstable