Designing a better API?

Question

1. What are the best practices and patterns to be followed for designing APIs?
2. How to achieve implementation hiding the best way (C++/Java)?
3. Designing APIs

Answer 1

Read Effective Java by Josh Bloch. The book is great for any Java programmer, but also addresses lots of issues surrounding the creation of a useful API.