Additional migration documentation for relationship types

[goneall]

Rather than removing support for the SPDX 2.X relationships, it looks like we can just reverse the direction and use one of the SPDX 3.X relationship types.

I also found one or two relationship types that was not documented.

[bact]

It looks the direction column is not complete as well (not your PR but the existing one). I will just copied my comments from #1017 (comment)

Questions

1. Does this table complete?
   • A sentence before the table said:

     Relationship migration is being worked out in the relationships spreadsheet. Once completed, the following table will reflect the translation for relationship types from SPDX 2.3 to SPDX 3.0:

2. What does "lifecycle scope" in the last column mean?
   • Other values in this column are types in LifecycleScopeType (for example, "build", "build, runtime", "test") or a string stating "various LifecycleScopeType".
   • Should this "lifecycle scope" string be replaced by "various LifecycleScopeType"?
3. The 3rd column ("Swap to and from?") probably not complete?
   • For example, 2.3 DATA_FILE_OF and 3.0 hasDataFile they are swapped in direction. But there's no "Y" marked in their column.
   • A (is a) DATA_FILE_OF B
   • B hasDataFile A

[bact]

@goneall do you mind to fix typo hasPrequisite / hasPrerequisite typo at line 242 please? So we can close #1017 and use this PR instead.

[goneall]

@goneall do you mind to fix typo hasPrequisite / hasPrerequisite typo at line 242 please? So we can close #1017 and use this PR instead.

Done

[goneall]

It looks the direction column is not complete as well (not your PR but the existing one). I will just copied my comments from #1017 (comment)

Questions

1. Does this table complete?

   • A sentence before the table said:

     Relationship migration is being worked out in the relationships spreadsheet. Once completed, the following table will reflect the translation for relationship types from SPDX 2.3 to SPDX 3.0:

2. What does "lifecycle scope" in the last column mean?

   • Other values in this column are types in LifecycleScopeType (for example, "build", "build, runtime", "test") or a string stating "various LifecycleScopeType".
   • Should this "lifecycle scope" string be replaced by "various LifecycleScopeType"?

3. The 3rd column ("Swap to and from?") probably not complete?

   • For example, 2.3 DATA_FILE_OF and 3.0 hasDataFile they are swapped in direction. But there's no "Y" marked in their column.
   • A (is a) DATA_FILE_OF B
   • B hasDataFile A

We should fix these as well - I won't have time to go through another pass before my trip - perhaps we can open a separate PR for the remaining questions.

Ping @kestewart

[bact]

We should fix these as well - I won't have time to go through another pass before my trip - perhaps we can open a separate PR for the remaining questions.

Agree. Let's merge this first and manage other stuff in another PR.

[bact]

I have open PR #1022, as a patch to @goneall's branch, to add all missing directions, fix typos in descendantOf and hasVariant names, and address all the three questions above.

[kestewart]

Thanks for the cleanup and making things more consistent.

[bact]

To future readers, this doc is no longer in this repo and is now available at https://github.com/spdx/using/