Swap "Examples" and "NoirJS/Guides" sections in Docs with a link to noir-examples

[Savio-Sou]

Problem

In the Examples section, we currently have one very outdated Merkle Proof Membership example.

Meanwhile in the NoirJS/Guides section, we also have one easily-outdatable End-to-end example.

Writing, maintaining and documenting examples at two different places (in noir-examples and in Noir Docs) is error-prone, labor-consuming and perhaps unnecessary.

Happy Case

1. Remove the Examples and NoirJS/Guides sections
2. Add a link to noir-examples in the sidebar

Alternatives Considered

• Leave everything as is, or
• Just remove the sections, but not add the link

Additional Context

Personal recommendation: external links in general should live as bottommost items on the sidebar to minimize distractions.

Would you like to submit a PR for this Issue?

No

Support Needs

No response

[kevaundray]

@Savio-Sou / @signorecello what is the status of this issue?

[Savio-Sou]

@signorecello clarified that noir-examples are not aimed to be fully up-to-date at all times:

#3711 (comment):

It is not meant to be up-to-date, unless breaking changes show up. By trusting the community to flag when some change goes undetected by devrel (which inevitably happens), we can keep them fairly up-to-date with the latest syntax without depleting all of our time.
So the happy case suggested in this issue does not necessarily address the problem.

As of #3711, the examples were moved into "How To Guides" and "Tutorials" sections that are now clearly separated from language sections in the sidebar. Reader confusions regarding outdated guides in docs could have been lowered since.

Given such, closing this as not planned for now.

If outdated guides in our docs as is are later found confusing / unhelpful still, we can consider proper approaches to update (e.g. binding examples to CI) or remove them.