> > Docile.jl looks great, but I think that the API should be made into > comments. One of Julia's goals is to have a simple syntax that even people > who are not acquainted with programming can easily understand. >
Python, despite using docstrings, is a great example of a language having "a simple syntax that ... understand" > I believe that a tagged comment is much more readable than a block > introduced by @doc or doc. > "Much more readable" is maybe a bit exaggerated, can you explain why you believe so?