update yarn config; deployment for JAPI

* the linking section is basically a copy of the old documentation
* I reworked the YARN documentation to reflect the rewrite.