Do you think if max had better docs ie, when you press F1 it came up with a proper description and example code like in b3d
You mean like blitzMax does when you press F1 twice?
Hitting F1 once it puts the syntax in the status bar, hit it twice and it takes you to the appropriate help page.