fix: update UDPs description and replace broken image links with raw github links

[rahmandawibowo-vito]

I notice there are some issues with the OpenEO UDP description:

• The description from OpenEO UDP is not the same with the markdown file stored on the algorithm_catalogue folder. For example, the Max NDVI markdown file description has more content under 'Example' part https://github.com/ESA-APEx/apex_algorithms/blob/main/algorithm_catalog/max_ndvi_composite_files/max_ndvi_composite_description.md?plain=1#L17 compared to the description property on the UDP description https://github.com/ESA-APEx/apex_algorithms/blob/main/openeo_udp/examples/max_ndvi_composite/max_ndvi_composite.json#L382. In this PR, I updated the UDP description using the content from the respective markdown description file.
• Some image urls on the description are broken because they are still using the relative path. I fix it by using the permalink to the correct image assets location.

[rahmandawibowo-vito]

Specifically for the world cereal UDP, the description is not completed yet plus there is no accompanied markdown file either. Is there any references I can use to update the description @HansVRP?

[soxofaan]

I'm not sure this is a structural solution to this problem: you can't expect users to produce this URL because it doesn't exist at the time they write the description, so they can not verify their work.

Can't this problem be solved when rendering the description? All the necessary bits should be available to produce the correct URL at render time I think

[rahmandawibowo-vito]

Actually at the moment we have added a logic to build this image url automatically, but the output is not always working. This is because there is a case where the image directory name doesn't have the same structure with the rest of the UDP here https://github.com/ESA-APEx/apex_algorithms/tree/main/algorithm_catalog/sentinel1_stats (in this PR, I have renamed the folder). If we can make this consistent, surely we don't need to rewrite the image url directly on the description.

[soxofaan]

Suggested change

	
	

If I understand correctly then

[soxofaan]

Minor update on this PR:
I'm afraid it's hard to approve/merge this PR as a whole, some fixes can be applied without further discussion, but other need some more thinking or discussion.
I'll see if I can cherry pick some things already.

cc @HansVRP @VincentVerelst

[soxofaan]

I just cherry-picked the issue with feature branch references in 523a16f

[soxofaan]

Regarding the remaining changes from this PR, I only think these changes of the UDP descriptions still make sense to look at (e.g. as new PR):

• openeo_udp/bap_composite.json
• openeo_udp/examples/max_ndvi_composite/max_ndvi_composite.json
• openeo_udp/sentinel1_stats/sentinel1_stats.json

[soxofaan]

to better reflect the state of this PR, I changed it to a draft PR

[rahmandawibowo-vito]

Regarding the remaining changes from this PR, I only think these changes of the UDP descriptions still make sense to look at (e.g. as new PR):

• openeo_udp/bap_composite.json
• openeo_udp/examples/max_ndvi_composite/max_ndvi_composite.json
• openeo_udp/sentinel1_stats/sentinel1_stats.json

Yes this PR seems larger that expected. I'll close this PR and create new PRs to fix the UDP individually.