refactor INTF

[larshp]

With 16+ years in ABAP I'm a newbie, and I have trouble reading the source code, this refactors INTF and removes all INCLUDE STRUCTURE, hopefully making it easier for humans to read.

It does however, sacrifice some reuse and introduces a bit of duplication, but IMHO its okay

Note that the schema field is removed from the header! $schema is not a json schema property, its a thing implemented in some editors like vscode. Editors have mechanisms to identify the correct schema for a file, I don't think we want to persist a URL inside the files, it might change in the future.

single definitions refactored to abapdoc + ABAP, instead of ABAP + abapdoc + ABAP, to

  "! Language
  TYPES language TYPE c LENGTH 2.

from

  TYPES:
    "! Language
    language TYPE c LENGTH 2.

which also follows https://github.com/SAP/styleguides/blob/main/clean-abap/CleanABAP.md#do-not-chain-up-front-declarations

[huber-nicolas]

It looks good to me

[schneidermic0]

Nice pull request. Thanks!

I didn't really like the includes in the types as well. I just added them for the sake of reuse, but it is fine for me if we duplicate code here. :)

Note that the schema field is removed from the header! ...
I don't think we want to persist a URL inside the files, it might change in the future.

We have to specify in which content version the content was stored. How would you add this identification? For me the $schema made sense to use it also as content version identification.
But I think, you are right we don't need it necessarily in the ABAP type. This could be also passed by the corresponding implementations to distinguish the content version.

There are some issues with ABAP Doc comments. I made suggestions how to fix them.

[larshp]

for versioning, I suggest deferring to #53 for possible solutions

suggestions committed

[schneidermic0]

Thanks.
We can follow-up versioning separately.