[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [p2-dev] @noimplement and @noextend annotation of IQuery

I wholeheartedly agree. And it's not just the wiki that needs improvements. All of it must also be formalized into the Eclipse help system. I will of course do everything I can do improve this but all help is very appreciated.

Comments like yours now for instance, help a lot. I wrote the implementation so I'm fairly deep down in the weeds and perhaps not always aware what needs to be explained. I'd appreciate more ideas about both structuring and content to make the docs really good. I added this bugzilla:

https://bugs.eclipse.org/bugs/show_bug.cgi?id=305462

as a common place for ideas and suggestions around the p2QL documentation.

- thomas


On 03/11/2010 08:53 AM, Meng Xin Zhu wrote:
It's definitely not easy to learn query language. The detail
documentation and a lot of examples are necessary to help us learn it by
ourselves. Otherwise, the teacher(Thomas) would be very busy to answer
the questions.

A suggestion for the wiki page of query language,

It'd better add some information to introduce how to find the attributes
of IArtifactKey. Why is 'classifier', and what else for other attributes
of IArtifactKey?

IQuery<IArtifactKey>  query =
QueryUtil.createMatchQuery(IArtifactKey.class, "classifier == $0",
classifier);