[root]: Butifying the link list

[CsatariGergely]

Closes #3044

[collivier]

Please rebase it (I cannot do it in Nokia's repo) - now gate is successful

[CsatariGergely]

Please rebase it (I cannot do it in Nokia's repo) - now gate is successful

@collivier Done now.

[gkunz]

sorry for the very late comment... If I understand the old solution correctly, Sphinx uses the heading of the index file pointed to for the name of the link. So instead of overwriting the links explicitly here, wouldn't a more consistent approach be to ensure that the headings in the target index files correctly named? Then we'd have the same name in both places instead of overwriting it here and once clicking on it, the heading is different. This can be confusing.

[CsatariGergely]

Yes I agree, that it would be more consistent, but that looks like a multi release project :)
What if we merge this as it is and I create the PR-s to update the target document titles and we gradually remove the overwites from here as the correction PR-s are merged?

[gkunz]

@CsatariGergely: that's totally fine with me. Let's separate the concept from the implementation. If we agree to aim for consistency, we can surely gradually update the docs to get there.