Как можно сделать документацию доступных API хуже на примере Apple. Самый интересный вариант - положить критичную информацию в видео и больше нигде о ней не упоминать, но есть и более банальные варианты.
https://kean.blog/post/apple-documentation