Mondjuk azzal nem értek egyet, hogy az rossz dolog lenne, hogy létezik API doc nem publikus kódra. Az API doksit fejlesztőnek írjuk, mert nem tudjuk jól és tömören kódban kifejezni azt, hogy mit csinál a kód. Ezért kell a fejlesztőnek dokumentáció.
És a nem publikus kódot is fejleszti valaki (a munkatársak), neki is kell dokumentáció, nem csak a publikus API felhasználóinak.