Move documentation to keycloak-client

[rmartinc]

Moving the documentation to the keycloak-client. The idea is the commented chapters are moved to the new keycloak-client project as guides. The plugin used in keycloak is copied but removed the specific keycloak parts (it's simpler). I don't think this will be changed a lot.

In order to complete the issue we need two more PRs in different projects:

• The PR to remove the chapters in keycloak: Move documentation to keycloak-client keycloak#32187
• The changes in keycloak-web to add the new section in guides (this one cannot be merged until a real keycloak-client package with the docs is released): Adding keycloak-client guides keycloak-web#482

The new guides are generated in the keycloak-web as a new section:

And each section is just a normal guide (for example the first one):

Draft for the moment.

[mposolda]

@rmartinc Thanks!

I have one small concern related to policy-enforcer javascript adapter. The JS adapter is still part of the main Keycloak repository and hence makes sense if it is still documented there. So can be better to either keep that one (file enforcer-js-adapter.adoc) in the keycloak and either keep in authorization-services docs or move to the JS adapter docs (which was already converted to guides). WDYT?

Copying the maven plugin from Keycloak is not so great, but IMO it is OK. Especially considering that it is relatively simple thing, which does not change too often and I don't see much better solutions for it, which are simple at the same time (anything more fancy can make things unnecessary complicated, so not sure if it worth it...)

[rmartinc]

I have one small concern related to policy-enforcer javascript adapter. The JS adapter is still part of the main Keycloak repository and hence makes sense if it is still documented there. So can be better to either keep that one (file enforcer-js-adapter.adoc) in the keycloak and either keep in authorization-services docs or move to the JS adapter docs (which was already converted to guides). WDYT?

Yes, no problem, I simply moved the whole chapter. 😄 I will move back to the documentation. Then I ned to change two of the three PRs.

[rmartinc]

@mposolda The policy-enforcer javascript adapter chapter has been maintained in the authorization services documentation and removed from the client.

[rmartinc]

Thanks @stianst! All done! I have picked all the commits and done the manual changes. The final version attribute for the client is client_version instead of client-version because the hyphen seems to be problematic. Thanks!

[rmartinc]

Rebased! It was needed.

[mposolda]

@rmartinc @stianst @pskopek Thanks for the PR and reviews