+1 from me.
Is there a bugzilla requesting to fix this, I can vote for?
Normally for every Eclipse project, one can vote for bugs. Everyone
has 10 votes.
In the GMF Tooling bugzillas, I do not have that opportunity. I
know getting that fixed is not trivial.
Regards, Philipp
Am 05.10.2011 10:50, schrieb Mickael Istria:
Hi all,
A comment from my blog post about GMF Documentation [1]
"
Well, from your post you link to quite a few pages, so it just
seems there are so many entries into GMF, and many places where
recipes are shared.
Conversely, for Graphiti, there is one official guide
located at help.eclipse.org. (To be honest there’s also an FAQ
which not all people find and so on. So there’s room for
improvement also there.)
To take an example:
http://www.eclipse.org/modeling/gmp/
Under “Getting started”:
The “Online documentation” links to http://help.eclipse.org/ganymede/index.jsp
This must be wrong..?
In the current http://help.eclipse.org
there is no GMF documentation. I don’t know if this is
intentional? (If I recall correctly GMF was back on the Indigo
release train..?)
The “tutorial” links to a page.. which simply has a link to an
other page.
"
It clearly appears that for a user:
* It is impossible to find an "official" documentation
* Documentation is broken https://bugs.eclipse.org/bugs/show_bug.cgi?id=359948
* The main Eclipse GMP site is out-of-date regarding... well...
almost everything about GMF.
IMHO, the wiki is the best way to make documentation available. It
is easy to contribute, easy to find stuff (thanks to the search
widget, well indexed on Google... However, although I put some
efforts in it, there are still some pages that deserves to be
improved [1] and links from this pages.
Having a look at GMF wiki, there are 2 kind of useful resources:
* Tutorial
* Howtos
I think we should split documentation that way. Currently there
are lots of pages with How To's. Having fewer ones would be far
easier to use.
But I think the real issue is: what is the official position of
GMF project regarding help? What links should really be on the GMF
website? It is time to make a choice, and to update the website
according to it.
|
