Okta API Swagger vs Okta API Reference

Hello, I am going through Okta API documentation right as I am tasked to provision a good chunk of our users to Okta.

I have also checked Okta-sdk-java on GitHub (https://github.com/okta/okta-sdk-java/blob/master/src/swagger/api.yaml) and have found out that there is a discrepancy. For instance I cannot find policy api (https://developer.okta.com/docs/api/resources/policy) in Swagger, for instance. Also I cannot find anything that talks about user/role/group relationship found in swagger but it seems nothing like this in the documentation.

Can anyone help me with this?

Thank you.