Specify the writer API

This involves some refactoring and rearranging to share one more algorithm around language availability between the two APIs. As part of this, we do some renames and add some definitions to clarify the language availability concepts.

Author: domenic