October 31st, 2014

Отображение JavaDoc в GitHub

Существует такая вещь как javadoc, которая помогает всем лентяем писать красивые (но, по большей части, бесполезные) каменты к своим программам. Вообще я считаю, что javadoc не есть good, поскольку мануал к серьёзной библиотеке не должен генерироваться непойми кем, но иногда, всё же, без него не обойтись особенно, если за написание комментариев вам не платят.

Существует другая вещь - GitHub Pages, которая позволяет вам запостить документацию к своему проекту. Сразу возникает вопрос - можно ли сочетать одно с другим? Не верьте тем пустобрёхам, которые скажут вам, что это невозможно, что нужно использовать *.md или что-то вроде. Они просто ламмеры не умеют читать мануалы. Сейчас я расскажу вам, как легко и просто отобразить страничку, сгенерированную JavaDoc в GitHub.
Collapse )