document MPI interop "best practices"

[Paul Hargrove]

In a previous meeting I promised to provide an adaptation of the Berkeley UPC recommendations for interoperability of UPC with MPI. Those recommendations are, with suitable edits, applicable to any GASNet-based runtime interoperating with MPI.

This issue is intended to hold me to my promise

Unless I am given specific instructions to the contrary, I plan to write either plain text or Markdown and commit as a new file in the docs/ directory. I will use a Pull Request to collect and respond to feedback before merging to the development branch.

[Paul Hargrove]

To ease collection of feedback, I have drafted this documentation in Google Docs and given Comment permissions to the Pagoda group. Once the text is stable I'll convert to Markdown and file a PR for it's inclusion.

cc: @bonachea

[Paul Hargrove]

I've opened Pull Request #2 with the proposed new file docs/hybrid.md

[Paul Hargrove]

Documentation for hybrid UPC++/MPI apps

Resolves issue #46

→ <<cset 166305136da0>>