| [gmf-dev] Better help structuration |
|
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: Under “Getting started”: It clearly appears that for a user: 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. |