Javadoc for core interfaces
Improves consistency for constructor params
Refactoring
Towards those PIE tests...