Improve guidance for working with application binary interfaces (ABI) in Java
Improve guidance for working with application binary interfaces (ABI) in Java

Summary: Incorporate guidance on how to design builds so that application binary interfaces (ABIs) are efficient.

Test Plan:
No code tests required; these are updates to the public-facing Buck documentation for application binary interfaces.

Before sending out my diff, I reviewed the Buck documentation in rendered form using a local web server. The script for doing this in in the Buck source tree. Here is the procedure.

Start the web server:

    $ cd ~/local/buck/docs
    $ ./soyweb-local.sh

    Listening on /0:0:0:0:0:0:0:0:9811

Go to your web browser and listen on the port where the server is running In the above example, that would be:

    http://localhost:9811/

I also run `aspell`, which is a command-line spell checker. On OSX, you can install `aspell` using `brew`:

    brew install aspell

Reviewed By: bobyangyf

fbshipit-source-id: 3b781d2

romanoid/buck,JoelMarcey/buck,brettwooldridge/buck,shs96c/buck,SeleniumHQ/buck,romanoid/buck,romanoid/buck,brettwooldridge/buck,SeleniumHQ/buck,Addepar/buck,clonetwin26/buck,facebook/buck,SeleniumHQ/buck,romanoid/buck,clonetwin26/buck,Addepar/buck,clonetwin26/buck,rmaz/buck,Addepar/buck,nguyentruongtho/buck,JoelMarcey/buck,shs96c/buck,LegNeato/buck,SeleniumHQ/buck,clonetwin26/buck,rmaz/buck,facebook/buck,kageiit/buck,LegNeato/buck,SeleniumHQ/buck,SeleniumHQ/buck,facebook/buck,romanoid/buck,clonetwin26/buck,SeleniumHQ/buck,shs96c/buck,SeleniumHQ/buck,rmaz/buck,romanoid/buck,rmaz/buck,LegNeato/buck,rmaz/buck,JoelMarcey/buck,brettwooldridge/buck,brettwooldridge/buck,nguyentruongtho/buck,JoelMarcey/buck,LegNeato/buck,brettwooldridge/buck,SeleniumHQ/buck,JoelMarcey/buck,zpao/buck,kageiit/buck,LegNeato/buck,shs96c/buck,romanoid/buck,romanoid/buck,Addepar/buck,LegNeato/buck,brettwooldridge/buck,Addepar/buck,JoelMarcey/buck,rmaz/buck,brettwooldridge/buck,facebook/buck,clonetwin26/buck,LegNeato/buck,zpao/buck,Addepar/buck,zpao/buck,kageiit/buck,shs96c/buck,romanoid/buck,SeleniumHQ/buck,JoelMarcey/buck,Addepar/buck,shs96c/buck,rmaz/buck,romanoid/buck,LegNeato/buck,shs96c/buck,facebook/buck,clonetwin26/buck,brettwooldridge/buck,rmaz/buck,clonetwin26/buck,kageiit/buck,LegNeato/buck,romanoid/buck,shs96c/buck,nguyentruongtho/buck,shs96c/buck,zpao/buck,zpao/buck,zpao/buck,kageiit/buck,nguyentruongtho/buck,Addepar/buck,romanoid/buck,SeleniumHQ/buck,shs96c/buck,shs96c/buck,clonetwin26/buck,JoelMarcey/buck,clonetwin26/buck,nguyentruongtho/buck,facebook/buck,JoelMarcey/buck,brettwooldridge/buck,SeleniumHQ/buck,Addepar/buck,Addepar/buck,rmaz/buck,shs96c/buck,JoelMarcey/buck,brettwooldridge/buck,brettwooldridge/buck,nguyentruongtho/buck,Addepar/buck,clonetwin26/buck,Addepar/buck,JoelMarcey/buck,zpao/buck,brettwooldridge/buck,facebook/buck,clonetwin26/buck,LegNeato/buck,LegNeato/buck,clonetwin26/buck,JoelMarcey/buck,LegNeato/buck,SeleniumHQ/buck,shs96c/buck,rmaz/buck,Addepar/buck,brettwooldridge/buck,rmaz/buck,romanoid/buck,kageiit/buck,rmaz/buck,kageiit/buck,rmaz/buck,JoelMarcey/buck,nguyentruongtho/buck,LegNeato/buck