doc: Stability 2 (stable) listed as "unstable" in fs docs

[Trott]

https://github.com/nodejs/io.js/blob/master/doc/api/documentation.markdown#stability-index indicates that Stability 2 = Stable but there are three places in the doc/fs.md where Stability 2 is marked Unstable. Not sure if the doc about stability index needs clarification, or if the fs doc needs to update those indices to different values, or ... ?

[bnoordhuis]

That's wrong and I believe I'm responsible for that in all three cases; mea culpa. They can be marked as '2 - Stable'.

[brendanashworth]

If I may, I think differently (for 2/3) - fs.watchFile seems to be unstable by the description suggesting an alternative. Perhaps this is related to #943?

[bnoordhuis]

fs.watchFile() is not really unstable, it's that in most cases fs.watch() is a better, more scalable alternative.

[brendanashworth]

Okay - @Trott would you like to send in a PR?

[Trott]

OK, done, PR submitted, #1775.

Not sure if it's less-than-ideal to have "Stable" right next to advice to use something else if possible. But that can be a subject of a different issue if necessary. The PR addresses the micro-issue of correctly labeling the stability index value.

[Fishrock123]

Fixed by eb1856d