To answer the clear question I can see in your post, we're restricted to returning only 25 players at a time for contractual reasons. Ideally, you would tailor your webservice requests to the data views that you actually need. For instance, if you need to get certain information about all players on a team, then ask for those players within that team context. If you need to get all of the players in the entire game in one big chunk, we unfortunately are not allowed to do that. Our stats provider would get mad at us.
Oh, I think you were also asking how to interpret stat information? As mentioned in my post, the league settings resource includes all the descriptive information about the stats we're using in a league -- easiest thing would probably be to ask for that resource within your code, output the response, and just take a look at that output. Seeing it should help give you a feel for how the schema is laid out and what you'll need to do to parse it.
Regarding the completeness of the documentation, yup, you're right. Still a work in progress, which is mostly why we're here to answer questions. As questions come up, we can improve the documentation based on what we see is lacking.
