DOC: advice on keeping Python 3 compatibility

Notes on things I had to change and things to watch out for.