I have been working with ACF for years but I am getting increasingly frustrated with the basic level of the documentation. I understand you want to keep it simple and accessible for most users, but there should at least be advanced documentation somewhere which follows the same patterns in terms of specifying exactly what a function does.
For example, while I have used the function update_field() 100s of times, I still forget what exactly is returned in the different situations, say, if field exists but has same value, if field does not exist, etc.
When I visit the docs https://www.advancedcustomfields.com/resources/update_field/ , I end up reading the whole thing over again just to try and find what the possible return values are so I can cover the responses in my application. The return values are not specified, so now I have to literally test all permutations myself again, write my own docs, or continue using google until I find a problem where someone has received an unexpected return value.
Please read the documentation page linked above. There literally is not a single mention of a return value. How is any developer meant to start using this function after reading the docs without a single suggestion of what might be returned, aside from testing all variations?
Every single function should have the basics explicitly specified somewhere. It is really that simple.
While I understand you want to keep ACF simple, given the actual complexity of the plugin and as a long time paying customer I feel the documentation is completely inadequate. I am really sick of testing for responses from functions. Please just compile proper documentation that covers the bases.
