Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [smila-dev] Applicability of http://wiki.eclipse.org/API_Central on smila/rt.* projects

That is true but API is API.  as I said in my other response (sorry, didn't see this one til after sending the other), this is all about contracts.  I would be very surprised if there is anything about SMILA that is different from what we see somewhere in the Eclipse project.  A great many projects at Eclipse use these guidelines and the PDE API tooling helps people understand and follow the guidelines.

Do not take the guidelines as gospel.  If there are things you disagree with or have a better solution for, I'm sure that the folks in the architecture council and the people maintatin API central would be very happy to hear about it.

Jeff

Thomas Menzel wrote:

hi,

 

i hereby  revoke this mail as we figured this out on our own.

 

namely: to quote from http://wiki.eclipse.org/Eclipse

The unfortunately named "Eclipse Project" is the project dedicated to producing the Eclipse SDK…

 

hence, indeed these guides are for the top-level project and not for projects at eclipse in general.

 

Kind regards

Thomas Menzel

brox IT-Solutions GmbH

 

From: smila-dev-bounces@xxxxxxxxxxx [mailto:smila-dev-bounces@xxxxxxxxxxx] On Behalf Of Thomas Menzel
Sent: Mittwoch, 24. September 2008 11:04
To: Markus Knauer; Jeff McAffer
Cc: Smila project developer mailing list
Subject: [smila-dev] Applicability of http://wiki.eclipse.org/API_Central on smila/rt.* projects

 

Hi,

 

i have a question in regard to how strictly the guides set out @ http://wiki.eclipse.org/API_Central and its subpages are for projects that build on the eclipse framework but don’t change its existing code.

 

as far as I understand the guide it is targeted mainly for (core) framework  development of eclipse itself.

in our case we are just building on that framework and although these guides make much sense to be followed I think they also add quite an overhead – especially when a software is in its infancy and direction/design of code is still under much discussion.

 

I do understand that since we haven’t released anything yet, all our APIs are considered provisional and hence subject to change.

even though, if we want to fully implement this guide it would mean a considerable effort to change code and hence wonder, how strongly this is seen for projects like SMILA.

 

Mit freundlichen Grüßen / Kind regards

Thomas Menzel

brox IT-Solutions GmbH


Back to the top