Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "API/EclipseCon2008Workshop"

(Topics)
(Topics)
Line 17: Line 17:
 
* Binary compatibility vs. source compatibility vs. contract compatibility
 
* Binary compatibility vs. source compatibility vs. contract compatibility
 
* API design process best practices
 
* API design process best practices
* API testing
 
 
* Exposing the API of an OSGi bundle:
 
* Exposing the API of an OSGi bundle:
 
** Import-Package vs. Require-Bundle
 
** Import-Package vs. Require-Bundle
Line 23: Line 22:
 
** Bundle version numbers and package version numbers
 
** Bundle version numbers and package version numbers
 
** Expressing dependency on execution environments
 
** Expressing dependency on execution environments
 +
* API testing
 
* ... add your own topic ...
 
* ... add your own topic ...

Revision as of 03:36, 13 March 2008

This page collects topics for the API Design Workshop at EclipseCon 2008.

Status: the workshop submission has been accepted for EclipseCon 2008! It will be held on Monday, March 17, from 8:00 a.m. to 12:30 a.m. in Room 203/204 of the convention center.

Abstract

In this workshop, targeted at Eclipse committers, we will work together on best practices for API design. This workshop will be run in an Open Space format to ensure maximum benefit for the participants. In advance of the workshop, participants will use a wiki page to sign up for the workshop and to coordinate topics they want to discuss or learn about. During the workshop, we will have several breakout discussion sessions about the topics that matter the most to the participants. Discussion notes or results will be posted on the wiki. The workshop organizer will bring a 4-hour slide deck about Java API design just in case. However, I hope that together as a group, we can do better than just listening to one individual.

Participants

  • Boris Bokowski, IBM Rational, Canada
  • John Arthorne, IBM Rational, Canada
  • Jim des Rivières, IBM Rational, Canada
  • Christopher Daniel, Poznan University of Technology, Poland
  • ... add your name...

Topics

  • Binary compatibility vs. source compatibility vs. contract compatibility
  • API design process best practices
  • Exposing the API of an OSGi bundle:
    • Import-Package vs. Require-Bundle
    • How to use Export-Package with x-internal, x-friends, etc
    • Bundle version numbers and package version numbers
    • Expressing dependency on execution environments
  • API testing
  • ... add your own topic ...

Back to the top