document yosemite API usage