From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matt Lundin Subject: Re: Documentation wishlist items Date: Wed, 16 Sep 2009 23:46:27 -0400 Message-ID: <8763biutbg.fsf@fastmail.fm> References: <9cd2f5ff0909151421r25e4c7afn8d609e76e2462193@mail.gmail.com> <87ab0v8buz.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mo7s9-0005GG-EV for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 23:41:29 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Mo7s5-0005Ed-SR for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 23:41:29 -0400 Received: from [199.232.76.173] (port=58145 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mo7s5-0005EP-H2 for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 23:41:25 -0400 Received: from out1.smtp.messagingengine.com ([66.111.4.25]:52148) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Mo7s4-00005l-SS for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 23:41:25 -0400 In-Reply-To: <87ab0v8buz.fsf@bzg.ath.cx> (Bastien's message of "Wed, 16 Sep 2009 17:42:12 +0800") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Bastien Cc: emacs-orgmode Bastien writes: > Hi Ethan, > > Ethan writes: > >> Another good example is TODO keywords, categories, and tags. It isn't clear >> what they all are, or why they are distinct, or what the differences are, and >> it's easy to confuse them with similarly-named but completely distinct concepts >> like properties. > > The manual might enjoy a glossary. ;) > > I have created org-glossary.org on Worg, please check it out and add > your own definitions: http://repo.or.cz/w/Worg.git O.K. So I went a little crazy and added a bunch of definitions to the glossary. - http://orgmode.org/worg/org-glossary.php Perhaps it's not so much a glossary any more as an shorter introduction to the basic concepts of org-mode. My apologies if I ended up repeating details from the manual, but my goal was to provide the following: 1) a brief definition of each term/concept. 2) a more detailed explanation of what it is and/or how it works. 3) possible uses (e.g., Why might one want to use categories?) I made a small dent in the list of terms. Please feel free to take up any of the remaining entries. Best, Matt