[doc] Update manifest to reference versioning spec

[mathisloge]

Currently only version-string is included in the manifest-files.md. However there are more variants of this field. This PR adds a cross link to the versioning specification.

fixes #17548

[mathisloge]

@NancyLi1013 maybe we should remove the whole #### "version-string" section and just add the link to the specification?
I don't think it's really maintainable or useful to have the information duplicated.

[NancyLi1013]

@NancyLi1013 maybe we should remove the whole #### "version-string" section and just add the link to the specification?
I don't think it's really maintainable or useful to have the information duplicated.

I agree with your suggestions. This section seems outdated. But since it is about version naming, we cannot remove it directly. We can rewrite this section. What do you think?

[mathisloge]

I was wondering if the changes introduced with 66619e0 are sufficient. Since all details are available in the specification (with examples) and the needed information, which fields exists are given in the table added with the mentioned commit

[mathisloge]

@NancyLi1013 the "thumbs up" is the indication that we will drop #### "version-string" in favor of 66619e0 ? 😄

[NancyLi1013]

@NancyLi1013 the "thumbs up" is the indication that we will drop #### "version-string" in favor of 66619e0 ? 😄

Currently, it might be not. I think we should rewrite this section. But I have no idea how to make it more reasonable. We have supported several kinds of version, only listing version-string here seems not good. The current changes look good to me. #### "version-string" section should be discussed.

Do you have any suggestion?

[ras0219-msft]

Further tweaks and consolidation is needed, but this is certainly an incremental improvement.

[mathisloge]

@NancyLi1013 From my point of view, the table with the possible fields would be sufficient. Since, in my opinion, all the information we would write here would be duplicated with the specification.
In my case, as someone who only updates or creates ports, this would be perfectly sufficient for me, since I know that there are other fields than version-string and I know where to look for examples and detailed information (in the linked spec.)

Maybe first merge these changes and discuss further changes in discussions or in a seperate PR?

[ras0219-msft]

Thanks for the PR!