It is a forward reference, but adding stuff to the doc is a little tricky right now as the doc probably needs a big overhaul and there isnt a clear point where this can be added. I like your other suggestion that makes it clear even without the programming guide.