[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [cross-project-issues-dev] Info Center for Neon.3

Sorry for the late reply. See comments inline.

On 13.04.2017 16:27, Gunnar Wagenknecht wrote:
>> On 13. Apr 2017, at 07:52, Frederic Gurr <frederic.gurr@xxxxxxxxxxx> wrote:
>> I have to disagree on that one. I'm pretty sure that quite a lot of
>> people rely on documentation for old releases.
> Frederic, I'm basically challenging two things:
> 1) How different and relevant really is old documentation?
> - I don't really by into the "misleading" or "confusing" argument
> - API/JavaDoc as well as plug-in development doc is the same
> - discovering features and api in newer doc could lead to additional motivation for adopting newer versions

>From my own experience dealing with updates for RCP based products, I
know that APIs definitely "went missing" (eg. presentation API) without
a sufficient migration guide. So it is IMHO very valuable to have old
documentation, be able to compare it and find it with a simple Google
search (instead of having to start 3 different versions of Eclipse,
start the clunky help browser and use the rudimentary search).

> 2) Spending valuable Foundation resources on things only a small subset of people need
> - IMHO IT time would be better invested focusing on a reliable infrastructure and services for projects and committers.

That's why we already automated most of the info center generation. So
this will limit maintenance to an absolute minimum.

> - If there are commercial interests in providing old documentation, companies should be able to come up with options themselves.
> - (Commercial) products based on RCP/IDE rarely rely on help.eclipse.org - they either host or ship their own help.
> - Help is (always was) included in old versions of Eclipse.

See above.

> If I recall, the goal of help.eclipse.org was to have a public service committers/developers/contributors could link/refer to when helping other users. IMHO it's also a valuable source when searching/researching something.

Yes, So let's keep up this great public service and not artificially cut
it down.

> Thus, in the interest of keeping things simple and being pragmatic, I suggest to only host the latest documentation on help.eclipse.org.

To be clear, I definitely don't want to increase time and effort spent
on the info center. My intention was just to find out if the community
sees a value in having an info center for every service release. Since
that does not seem to be the case, it's now even less work than before
(thanks to automation).