You might like to try my doktor package (not on hex yet), which targets your preferences. You can write your docs as a markdown file with special comments and doktor will extract them from the file at compile time and add add them as @doc attributes.
2 Likes
