Plan issue index to provide straightforward way for reviewers to point to examples.

I think I understand the desire for a 'one place' for examples but I am not convinced that adding another way to document examples is the way to go. For me, examples should be added to core API docs.

The idea behind this is more a reference for how to solve issues in core, if you think an index in the docs is the place for that we can look at that.

I am trying to say that the reference is the documentation in core and it can be searched on api.drupal.org. Of course, that documentation can be improved. I think our efforts are better spent on improving the docs themselves instead of adding an index layer. For example. if we put effort into issues such as 🌱 Document high-level API concepts in an easier format Active then we will be making it easier for to improve the documentation. And once we can use a markdown, which more people are comfortable with, we should see an improvement in quality and quantity of our api docs.