URLs to Images - links must go to raw content, not to blob

[GillesInnov35]

Problem description
I searched for some good documentation practices and found some issues, for correction.

1: The file kyc-match.yaml from r2.2 contains an absolute URL (link) to the main branch. This may lead to inconsistencies, when updating the picture in the wip branch.

Expected behavior
Discuss the issues and take according actions.

Alternative solution

Additional context

[GillesInnov35]

@ToshiWakayama-KDDI , from what I see in KnowYourCustomerMatch Documentation the assets folder has not been copied and no files have been copied. Do you know why ?

[FabrizioMoggio]

This is an example for an image file linked in the OAS for a specific release (QOD API):

https://raw.githubusercontent.com/camaraproject/QualityOnDemand/**r2.2**/documentation/API_documentation/resources/QoD_latency_overview.PNG

We should do the same, including the release tag in the path. Also updating the URL to refer to the new Repo.

We can fix it after the review from the release management team.

[FabrizioMoggio]

By the way, I'm sorry, I had previously misunderstood the issues.

[FabrizioMoggio]

Fixed because of a request by the release management group

[hdamker]

@FabrizioMoggio @GillesInnov35 As you can see from the above example from QoD, the link must be a "raw" content link of GitHub, but the current link in the API definition is going going to the "blob" in the GitHub UI. As a result the picture is not shown, as you can verify here: https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.1/code/API_definitions/kyc-match.yaml

Same issue in KnowYourCustomerFill-in: camaraproject/KnowYourCustomerFill-in#21

[FabrizioMoggio]

The right path should be:
https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.1/documentation/API_documentation/assets/kyc-match_flow.png

[FabrizioMoggio]

Fixed with: #28

[ToshiWakayama-KDDI]

Let's close this PR as fixed with #28 . Thanks.