SC documentation improvements

[dg-concordium]

Purpose

Improve smart contract documentation based on comments from Kasper and some outstanding pull requests. Note that this does NOT include changes to the tutorials.

Changes

A number of sc files
Conf.py (redirects)
Requirements.txt because something broke

Checklist

• My code follows the style of this project.
• The code compiles without warnings.
• I have performed a self-review of the changes.
• I have documented my code, in particular the intent of the
  hard-to-understand areas.
• (If necessary) I have updated the CHANGELOG.

CLA acceptance

_Remove if not applicable.

By submitting the contribution I accept the terms and conditions of the
Contributor License Agreement v1.0

• link: https://developers.concordium.com/CLAs/Contributor-License-Agreement-v1.0.pdf

• I accept the above linked CLA.

[limemloh]

Looks good! Nice work. I have some minor suggestions and discussions, but nothing blocking.

[Bargsteen]

Nice work 👍

[dg-concordium]

I think I got all of the videos embedded, but please check to make sure that I got the correct ones in the correct places as the copy/paste got a bit confusing.

[dg-concordium]

All of the changes should be done. Please review @Bargsteen and @limemloh.

[Bargsteen]

I noticed that the dimensions of the videos are fixed and they seem small at least on my screen.

I think we should remove the fixed dimensions (560x315) for all of our videos and add a CSS rule:

iframe {
   width: 100%;
   aspect_ratio: 16 / 9;
}

(We can also add a youtube class, but I don't think we'll use other iframes)

As that gives us this:

It also scales better on small devices.
We should also describe how to embed videos in our readme and explain that you should remove the fixed dimensions.

[dg-concordium]

Once again, the changes are made. Please review @Bargsteen

[github-actions]

PR Preview Action v1.4.6
Preview removed because the pull request was closed.
2024-02-02 12:48 UTC

[Bargsteen]

Nice 👌