With the new richly featured topology system that has a lot of fields not self explanatory there needs to be a level documentation that someone completely unrelated to the project would be able to use the docs and references and generate new topologies for themselves (since this is essentially what 3P processors are doing). This would require detailed meaning for all fields, how they are used and no assumptions on knowledge of TLAs.
With the new richly featured topology system that has a lot of fields not self explanatory there needs to be a level documentation that someone completely unrelated to the project would be able to use the docs and references and generate new topologies for themselves (since this is essentially what 3P processors are doing). This would require detailed meaning for all fields, how they are used and no assumptions on knowledge of TLAs.