[DO NOT MERGE] Documentation update review

[deusebio]

@grobbie @marcoppenheimer @zmraul @a-velasco

[a-velasco]

LGTM! I really like the new reference tables.

[zmraul]

@deusebio @a-velasco fyi related to changing command relate -> integrate.

[~]$ j remove-integration kafka zookeeper                                 
ERROR juju: "remove-integration" is not a juju command. See "juju --help".
                                                                          
Did you mean:                                                             
        remove-relation                                                   

Should we keep it as relate until remove-integration exists?

[deusebio]

I'm not sure there is any plan in Juju to also have remove-integration. I would agree that it would make things more consistent, but if there is no actual plan, we should not constraint one to another. Either way, I suppose we should move away from juju relate as this appears with deprecated warnings in the logs.

Anyhow, I don't mind too much. Up to @a-velasco to make a call such that we keep documentation consistent across DP.

[deusebio]

Actually I just found this just spot on.

TLDR remove-relation still makes sense.

integrate is the verb, relation is the noun. So the action/verb is integrating, but whenever we refer to something, it is a "relation", e.g. "Integrating is the action of creating a relation`

[deusebio]

superseded by #175