Please add [edit this page] link to all EUI doc pages

[nyurik]

Many Elastic and other FOSS projects include edit this page links on each documentation page, allowing users to contribute minor improvements without too much effort -- e.g. using GitHub's online editor to edit and create a PR. Could something like this be added to EUI as well? Thanks!

Somewhat related to #3508

[snide]

I'm not so sure about this one. We get a pretty sizable amount of community contributions already, and usually those "edit this page" style links are for highly textual documentation, where EUI's docs tend to be pretty complicated (multiple pages to make a single view) and visual.

I'm worried it would distract from the content of the page, which already are pretty busy.

[nyurik]

@snide I tend to see a lot of those at the bottom of the page, e.g. here (bottom left), or take a look at the elastic search docs -- on the side and semi-transparent (btw, asciidoc is even worse at their file-to-page structure). It could even be show-on-mouseover style and hidden otherwise. I think it makes the site more welcoming to the user contributions, encouraging users to participate than just to use.

[chandlerprall]

We discussed as a team and decided not to implement this - at least for now. We don't believe most edits to our docs can really exist as a single-file change of copy (with exceptions for spelling/grammatical issues). As a page is comprised of sections containing examples, each with a separate code file, it would be difficult to know which of these an edit link should target.