API reference MUST use canonical prototypes/declarations.
Actual platform API reference is awful. It's hard reading even for programmers, what makes you think that it would be good for beginners ?
Let's keep pretty weak structure for other discussion (fortunately, it could be overriden with site search). Real problem is functions/methods articles.
Arguments ? Default values ? Overloaded versions ? Return values ? You need to read whole article to bring them together. But some aspects even missed. For example, what the actual type of Stream::readStringUntil() return value ? (i.e. how could I get it know from article)
Why don't you use canonical prototypes or even Doxygen, instead of re-inventing your own wheels ?