Comment by raggi | Hacker News Reader

Top New Best Ask Show Jobs

Comment by raggi | Hacker News Reader

Parent Full thread

no. blogs are not a substitute for documentation.

ruby has been suffering this for too long.

blogs have several problems:

- they don't get updated - they don't get patched - they don't ship with the software - they break when the user dies / moves / leaves / changes software - they have a lower signal to noise ratio

- they accumulate Google juice over time, overpowering advice for newer versions of your framework.

Or even worse, when half the documentation is a screencast.

You are correct. So I suppose I should alter my previous post by saying that it is a good way to go iff you are also willing to be diligent in your updates to keep the documentation as current as possible.

Reply on news.ycombinator.com