You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In the setq sexp of the .spacemacs.template the documentation comment precedes (comes before) the coded variable name. In "normal" lisp the doc-string follows the definition. Depending on the chosen syntax highlighting this is more or less confusing in my opinion. Generally i would prefer the coded variable name before the docstring in this case the explaining comments.
You may call me nitpicking.;-)
The text was updated successfully, but these errors were encountered:
I think we'd be doing ourselves a disfavour by moving them. It's a fairly widespread convention that comments come before the code that they are explaining.
We can't change the Emacs Lisp docstring conventions, however.
In the setq sexp of the .spacemacs.template the documentation comment precedes (comes before) the coded variable name. In "normal" lisp the doc-string follows the definition. Depending on the chosen syntax highlighting this is more or less confusing in my opinion. Generally i would prefer the coded variable name before the docstring in this case the explaining comments.
You may call me nitpicking.;-)
The text was updated successfully, but these errors were encountered: