Documentation is harder to follow then it should be.
Wanting to use realm over firebase but can't help but feel the time I waste navigating the docs would be worth just having used firebase...

Absolutely love the feature sets I see but just not that clear how to implement them :/.
In particular I have seen conflicting messaging around authentication, some places advise that mongo app services authentication is not intended as a full authentication and should use other platforms. Why?

That made me look at firebase auth with realm ... using custom jwt. Surely you can just create a proper auth method? Maybe it already is, in which case just goes to show how confusing the messaging is across the docs.

fyi trying to use realm with flutter. I realise its in early release but just in general docs are hard to follow.

Cloudflare did a full redesign of docs maybe ask them for advice :).