This is an old subject but with a new twist recently. It seems to be more important than ever to avoid having two pages about the same keyword than ever if you wish for both pages to rank. I'm looking at an established site right now that has been steady in serps for over 6 years that suddenly is not doing as well and many of the wrong pages are appearing for any given keyword(and much lower than the right page was ranked).
Almost 7 years ago a "similar articles" section was put in that had a thumbnail image and text link to similar pages. Suddenly, as of last week, pages with a "similar link" to any given page is ranking ahead of the actual article.
Again, one page ranking poorly because it is ranked for keyword(s) of a better page that would rank more highly isn't new. I'm just seeing a lot more of it this week. Pages with one mention of a keyword seem able to rank more highly than a page about that keyword on a site if the page containing just a link to the other page is also well ranked for something else. The problem with this is that the page will rank much worse than the desired page would and it completely blocks the desired page(not found at all when it's been eclipsed like this).