Thorsten Jolitz <tjol...@googlemail.com> writes: > Achim Gratz <strom...@nexgo.de> writes: > >> Looking at the documentation and also the website and Worg, I see that >> we still use all these monikers interchangeably in both capitalized and >> lowercase form throughout. I seem to remember that there was some >> discussion that only one of them should be used going forward, but I >> can't find it... >> >> >> Regards, >> Achim. > > look at: > /org-mode/doc/Documentation_Standards.org > > in your Org-mode (?) distribution
See below for an historical data point. I wrote that standards doc after an off-list discussion/agreement with Carsten and Bastien back in early 2008 and just before I made an effort to tidy up these sort of issues in the docs. Obviously Org development, awareness and use has exploded since those days and so it seems reasonable to check whether what we said back then remains relevant today. I don't really mind what the standard is but I certainly agree that having one is a good thing. Regards, Phil --------------- From: Carsten Dominik <carsten.domi...@gmail.com> Subject: Re: Documentation standards To: p...@yax.org.uk Cc: b...@altern.org Date: Wed, 26 Mar 2008 19:40:08 +0100 (4 years, 9 weeks, 5 days ago) Dear Phil, I am pretty much happy with all the proposed changes, below are some comments. [...snip...] > 7) [...] Thus I have seen Org-mode, org-mode, org or Org referring to > the mode itself, the function 'org-mode' and then a variety of > 'org-mode-...' functions and variables. I would like to standardise > on Org when referring to the mode (as a noun if you like) and > org-... in all other instances. I think it will also work better with > the way a number of other modes (eg Calc) are also already referenced. > Likewise, I would also like to disambiguate Orgtbl the minor mode, and > others, from references to that mode's functions and variables. I am all for it. I thought that I have used "Org-mode" very systematically throughout the manual, but maybe I am mistaken. If you choose "Org", how about the following: Let "Org" refer to the system as a whole, not narrowed down to the mode. Because in fact, Org contains a number of different major modes. So use org-mode or Org-mode when you specifically mean the major mode in .org files and its properties. Use Org as the general term which then in places might be used instead of org- mode if there is not misconception possible. - Carsten
