From mboxrd@z Thu Jan  1 00:00:00 1970
From: John Hendy <jw.hendy@gmail.com>
Subject: Proposal for new/updated exporter tutorials on Worg
Date: Wed, 27 Mar 2013 23:51:46 -0500
Message-ID: <CA+M2ft8+CJe_s--GU7EkcuqqVb2-tZdpA=X3s8wQUb2DsSRAzQ@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([208.118.235.92]:45388)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jw.hendy@gmail.com>) id 1UL4oX-00071M-5E
	for emacs-orgmode@gnu.org; Thu, 28 Mar 2013 00:51:50 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <jw.hendy@gmail.com>) id 1UL4oV-0000A2-W1
	for emacs-orgmode@gnu.org; Thu, 28 Mar 2013 00:51:49 -0400
Received: from mail-ob0-x230.google.com ([2607:f8b0:4003:c01::230]:43272)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <jw.hendy@gmail.com>) id 1UL4oV-00009v-R2
	for emacs-orgmode@gnu.org; Thu, 28 Mar 2013 00:51:47 -0400
Received: by mail-ob0-f176.google.com with SMTP id er7so5316129obc.35
	for <emacs-orgmode@gnu.org>; Wed, 27 Mar 2013 21:51:47 -0700 (PDT)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: emacs-orgmode <emacs-orgmode@gnu.org>

Greetings,


I just pushed a changed to the 8.0 upgrade guide (scroll all the way
to the bottom):
- http://orgmode.org/worg/org-8.0.html

It features a table similar to that of the Babel languages:
- http://orgmode.org/worg/org-contrib/babel/languages.html

It simply lists the exporters Org offers, their .el location with
respect to Org directory (either in ./lisp/ox-* or
./contrib/lisp/ox-*) and a column for what I hope will turn into links
to updated exporter tutorials/detailed documentation similar to what
exists for Org Babel. Currently, Org exporter tutorials are spread
between =worg.git/org-tutorials= and =worg.git/exporters=. It looks
like the most up to date have started settling in
=worg.git/exporters=; what does the list think about deciding to stick
with that as the home for all new ox-* related documentation on Worg?

I'd propose they simply be titled according to the new names,
=worg.git/exporters/ox-*=.

I'm happy to help with a template (probably just porting
ob-doc-template to ox-template or something like that). I think the
Babel table is great; perhaps after Org-8.0 actually launches, the new
exporters could receive a similar "landing page"
(=worg.git/exporters/ox-summary= or similar) where that table could
reside and be updated as the new platform grows.

Individuals could contribute and add links at the table they can. I
think getting placeholders created for each exporter in the very near
future (which I also volunteer to do) will be really helpful as the
official shift to 8.0 happens. It will lower the barrier to entry for
getting information out of the mailing list and into Worg (I
anticipate lots more questions as infrequent upgraders/non-git users
migrate over).


Thanks for any comments/suggestions!
John