On Mon, Jan 22, 2018 at 8:51 AM Nicolas Goaziou <m...@nicolasgoaziou.fr> wrote:
> > org-edit-src-content-indentation: ? > > It is 2. I'd favor 0, but I don't care much. > I also favor 0, less white space noise, the better. > > This is necessary so that contributors don't mess up accidentally with > > the desired format. > > Why does it matter? We just put them in ".dir-locals.el" and be done > with it. They override user's preferences anyway. > +1 > > Also, why are :PROPERTIES: drawers at the beginning of the line? > > I set `org-adapt-indentation' to nil in the file above. It gives more > columns in a line, which I find more comfortable (e.g., text always > starts at the same column). > Another place where we can prevent unnecessary white space. I have always started PROPERTIES at col 0. With org-indent-mode enabled, it doesn't matter.. looks pretty (PROPERTY drawer in below screenshot actually starts at col 0): [image: image.png] > - use example blocks for Org syntax instead of "begin_src org", > I'd prefer "begin_src org". When these manuals are converted to HTML, we can use syntax highlighting to format comments, etc in Org snippets. I think it's good to retain the meta data that that is not an arbitrary block of text, but Org data. Can you please revert to "begin_src org"? > - internal links to headlines always start with a star, > Nice. - tags, node properties, are not shown with the surrounding columns, > - when to use =...= or ~...~ markup: > - files or extensions use =...=, > - anything that is meant to be written in the Org buffer uses =...=, > - any meaningful token in a programming language uses ~...~. > Sounds good. -- Kaushal Modi
