I've made a little bit of documentation for Pygame_SDL2 available at: http://pygame-sdl2.readthedocs.org/en/latest/
Right now, it focuses on the places where Pygame_SDL2 extends the Pygame API. A goal of these extensions has been to be backwards-compatible - an application that is ignorant of the new features should be able to run unchanged. Comment on these extensions is welcome.