134 complete chapter road network structure 735

[lyndyRott]

Describe your changes

According to the information in issue #134, I extended the documentation of the environment by

• updating the suggested model-structure document/template w.r.t. the discussion and
• renaming the directory and documents from object-road-network to environment, representing the root.
• adaptation in object-classes adoc to include the renamed directory "environment" with its index document.

Changes:

What has changed:

• This is an extension of the documentation according to the discussion
• An adaptation was made according to Simone's suggestion, adding Cover-category
• An adaptation was made w.r.t. building, vegetation and other-objects: adding indices

Questions:

General:

• descriptions: please review and adapt anything, as required.

Categories: Buildings, Vegetation, Other:

• do we need indices? (indices were added; otherwise: remove)
• do we need transformations for these? (not added)

Issue ticket number and link

134

Mention a member

Please review the first trial thematically (and the correctness of the adoc standard, as I am not familiar): @LudwigFriedmann @ipg-sig

Checklist

• [ ] this is a first trial of both content description and adoc-usage
• [ ] the current state is only a start for adapting the structure and needs more content-input by Ludwig Friedmann, as agreed on during the last Geometry meeting (not a pull request yet)

[FKlopfer]

@LudwigFriedmann , should we perform a linguistic review now or wait until further feedback is provided?

[ClemensLinnhoff]

@LudwigFriedmann , should we perform a linguistic review now or wait until further feedback is provided?

I just did some cleanup. Now it is ready for editorial review @FKlopfer. There are some coordinate definitions and all images missing, but let's tackle that in a separate PR.

[lyndyRott]

Thank you, Clemens, for doing the clean-up. I was not sure, if I should do it.

The coordinate definitions will be added by Ludwig. It makes sense to do this in a new branch, probably?!

Concerning images, I do not have any 3D visualizations for the defined classes (which are free of 3rd party IP). Maybe someone with more experience in generating these can support?

[ClemensLinnhoff]

Yes, let's do the coordinates in a separate branch. The images can be done by @ACMackenthun after we have done the coordinate definitions, also in a separate branch.

[ClemensLinnhoff]

So, after the editorial review by @FKlopfer we can directly merge this branch.

[LudwigFriedmann]

@lyndyRott and @ClemensLinnhoff: I'd also vote for a merge after the review by @FKlopfer . I'll add the coordinate frames afterwards.

[mettelilienthal]

@ClemensLinnhoff @LudwigFriedmann @lyndyRott I've done the editorial review.