> To me the only difference is that I `> really don't want to write > > @doc """ > commentary > """ > function ... > > > whereas I already write things along the lines of > > # commentary > function ...
doc "function doc" function ... is already better, and then let's get rid of even the doc keyword. It would be kind of less breaking a change, as currently comments are mainly written for developpers consumption and not meant for documenting public API and would need to be fixed all at once. As both developper comments and API documentation are needed, I find it useful to have two distincts means: comments and strings.