----- Original Message ----- | From: "Sean P. DeNigris" <sean@clipperadams.com> | To: pharo-project@lists.gforge.inria.fr | Sent: Monday, May 14, 2012 8:11:19 AM | Subject: Re: [Pharo-project] Semantic Versioning | | | Right, first you'd have to specify public packages/categories or | individual | classes (which would be helpful with of without semantic versioning. | I | sometimes find it difficult to know what classes I'm supposed to use | in a | library when private helper classes pollute the package/category). | Then, any | method there that's not in 'private' would be API. Sean, I've always been intrigued by Interfaces in Java...not the interlocking-typing system, but the fact that the public api is explicitly called out. I would think that we could start creating a InterfaceOfXXX class that specifies the public classes and API ... perhaps the class comment would be the primary project documentation... It's a convention, but could be very useful: you can use specifications for validation of test coverage and dependency calculations... Dale