Suggestion: Regarding documentation of Elastic Search

[abdulqayyum]

Recently, I was caught in two very small issues. Later what I found out that what documentation I was looking at was not sufficient and I need to look at further documentation in that regard.

Example is this Stack Overflow issue where I referenced different documentation and two of the other ended up showing me different documentation.

I was concerned and Russ Cam asked me to open an issue here, What I want is why can't we show related documentation when on a page so that if I was reading this document about SourceFilter it should have shown me its related documentation like this one about Selecting Fields to Return as well as this one about Field Inference.

Moreover, currently I save documentation by tools like evernote etc. to save essential documentation why can't we just bookmark it or download as pdf if needed?

[russcam]

Thanks for opening @abdulqayyum.

I'm not sure how feasible it would be to link to every relevant page from a usage page, as I think this could become noisy very quickly e.g. "In order to understand X, first you need to understand Y and Z; in order to understand Y, first you need to understand V and U."

I'm thinking about the idea of making the conventions and common types sections more prominent, and including examples of their usage within NEST APIs.

[Mpdreamz]

Closing this due to inactivity and containing nothing actionable beyond what we already have in #2248 .