Cross-lingual pwsim

necessary changes to code and documentation for a step-by-step tutorial...