I've been using the pybind11 wrapping guide to wrap jointcal, and it's generally been quite helpful, but there were a few questions it didn't answer for me.
- what to change/add in python/SConscript and _init_.py.
- how many of the wrapped modules to include in _init_: should they all be included as a general rule, or just those that one definitely wants to be accessible from python?
- How to choose between clsBlah and cls when naming the wrapped code (it's discussed in the style guide, but it would be useful to say something about it in the wrapping guide, with a link to the style guide sections).
- how to import new pybind11 modules in python (no more blahLib).
It might be useful to also have a list of "how to remove all your SWIG stuff", for those dealing with packages that were previously SWIGed.