Dokumentacja kodu

Witam,
chciałbym się zapytać w jaki sposób udokumentować mój kod, żeby potem można było wygenerować dokumentację do niego.
Czy te komentarze dokumentacyjne wystarczy zawrzeć w zwykłych “#”, czy jest jakiś inny wymóg?

z góry dziękuję za pomoc

Zależy z czego będziesz korzystał, np. http://rubydoc.info/docs/yard/file/docs/GettingStarted.md (wydaje mi się, że jest to tam całkiem dobrze wytłumaczone)