Integrate Kwant paper into the documentation
Quite some effort went into writing the the Kwant paper. We could integrate most of this material into the Kwant documentation. Here are just some ideas:
• The stadium example could be the new beginning of the tutorial
• The tutorial could end with the “real world” valve example
• The paper secion on solving the scattering problem could become a chapter of the documentation.
• The technical appendices could be either integrated into the tutorial, or form (perhaps together with the section on the scattering problem) a sort of “user guide”. (Perhaps it’s too much to have a tutorial, an user guide and a reference guide, so I think I prefer integrating into the tutorial.)
I do not think that this will negatively impact the citations of the paper (I don’t think that we get cited because people read the paper). It could even help if in some documentation sections we refer to the paper as the basis of the material.
I do not consider this issue to be urgent right now, but it will become more important as Kwant keeps evolving from the version that is described in the paper.
Comments?