Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [cdt-dev] Screenshots in the Reference documentation

I vote for getting rid of them.


On Thu, Mar 21, 2013 at 4:47 PM, Jesse Weinstein <jesse.weinstein@xxxxxxxxxxxxx> wrote:

Currently we have (mostly very out-dated) screenshots at the top of most of the menu, preference and other reference documentation pages (e.g. in the org.eclipse.cdt.doc.user plugin).  I’m not actually convinced that the screenshots are actually a Good Idea. They require the help pages to be very wide, which prevents their use in context (i.e. when you click on the (?) in the preferences, they require regular updating, and they are not consistent across platforms. And basically, they’re redundant with the actual menus or preference panes.


Looking at the other manuals, it’s a mixed bag. JDT doesn’t have screenshots; the Platform has them, but they aren’t at the top; PDE has them for preferences, but not for menus (although that might just be because it doesn’t have much menu documentation); EGit has lots (in a somewhat confusing arrangement); the _javascript_ Development Guide has them (with a vast amount of whitespace). So I suppose they are overall more used than not, but I’m still not convinced they actually add anything.


I’d love to hear folks thoughts and opinions on the topic…


cdt-dev mailing list

Back to the top