[PATCH] D51297: [docs] Create a guide for Vim users on how to setup Clangd

Ilya Biryukov via Phabricator via cfe-commits cfe-commits at lists.llvm.org
Mon Aug 27 06:12:44 PDT 2018

ilya-biryukov added a comment.

In https://reviews.llvm.org/D51297#1214313, @kbobyrev wrote:

> In https://reviews.llvm.org/D51297#1214297, @ilya-biryukov wrote:
> > Do we want to keep the docs for different editors separate or do we want to put them all into a single page in case we add more editors?
> >  I would vouch for keeping them on a single page, but that's not a strong opinion. Wonder what other people think?
> This one is pretty long and might scare some people off if we push this to the main documentation file IMO. However, creating a separate page for Vim integration might make it harder to discover the page itself, which is another problem. It seems like both options have their downsides, I'm not sure which one is better.

Exactly the trade-off we're facing here. Not sure either. I'm personally not scared of big documents if there are links/TOCs to navigate to relevant parts. The "hard to find" bit looks like more of a problem to me.


More information about the cfe-commits mailing list