27

When you spend 2 days trying to figure out why your shit is breaking just to realize you have been reading v2 docs and not v3 #fml

Comments
  • 4
    Just wait until they release v4 but don’t update the docs for six weeks.
  • 3
    So thats why they say "documentation can lie, code cant"
  • 1
    @hubiruchi indeed, read the source when available. Teaches you quite a lot.
  • 2
    If you develop API the best thing you can do is version them:
    foo.com/API/v1/FindBarByID?Bar=1
    —returns Bar JSON Object v1
    vs
    foo.com/API/v2/FindBarByID?Bar=1
    —returns Bar JSON Object v2
  • 0
    That was my Tuesday, though reading v3 and on v2!
  • 1
    Are you reading Boto documentation? I've been there
  • 0
    This is also fail of the docs, which upon googling should always show the latest version, and if you want, you should be able to switch.
  • 0
    @piehole the docs cannot do much about it. When I google something about laravel it will show me the latest docs 9 out of 10 times. Once in a while I look for something which had a rename. And will get the old docs.

    When I lookup the docs manually it will show me the latest stable version.
Add Comment