В Java, если вы упаковываете исходный код (.java) файлы в банку вместе с классами (.class) большинство IDE, как eclipse, будут отображать комментарии javadoc для завершения кода.

IIRC Есть несколько проектов с открытым исходным кодом, которые делают это, как JMock.

Допустим, я четко отделил свой код API от кода реализации, чтобы у меня было что-то вроде myproject-api.jar и myproject-impl.jar. Есть ли какая-то причина, по которой мне не следует помещать исходный код в мой myproject-api.jar?

Из-за производительности? Размер?

Почему другие проекты не делают этого?

РЕДАКТИРОВАТЬ: Кроме проблемы загрузки Maven будет больно что-либо, чтобы положить мои источники в банку классов для поддержки как можно большего числа разработчиков (maven или нет)?