DOC: add code compatibility note
Merge branch 'maint/0.5.x'

* maint/0.5.x:
  DOC: add code compatibility note