emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Vikas Rawal <vikaslists@agrarianresearch.org>
To: John Hendy <jw.hendy@gmail.com>
Cc: org-mode mailing list <emacs-orgmode@gnu.org>
Subject: Re: Using Emacs, Org-mode and R for Research Writing in Social Sciences
Date: Tue, 13 May 2014 20:40:13 +0200	[thread overview]
Message-ID: <4EAA0890-F121-49D9-B643-9891204F43E5@agrarianresearch.org> (raw)
In-Reply-To: <CA+M2ft9SokrY+uCmUA0ZXxSqa8qs0+8zoCiE=jG_Fb-gDN9FWw@mail.gmail.com>

> 
> It seems safer/efficient to focus on making modular documentation that
> is the definitive *best*/*right* way (and *best* explained) to do
> something, and then to link to that prolifically.
> 

Your points are very valid and expressed convincingly. 

Writing this document was a result of, first and foremost, a personal urge to write it, and secondly, in view of very specific use cases (my graduate students, to whom I wanted to provide a one-stop shop, before they explore rest of the stuff).

That said, your arguments that it is not optimal to include such a document as part of documentation on orgmode.org is perhaps right. I can see that maintaining modular non-repetitive content is easier. Long-term maintenance of documentation should be an important concern for something that is under heavy development. 

Unless others feel differently, I would let the document float around the cyberspace, on my personal website and on github, for anyone to discover and use.

Thanks for your very reasonable comments. 

Vikas

  reply	other threads:[~2014-05-13 18:40 UTC|newest]

Thread overview: 26+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-05-12 12:57 Using Emacs, Org-mode and R for Research Writing in Social Sciences Vikas Rawal
2014-05-12 13:26 ` Suvayu Ali
2014-05-12 19:36   ` Vikas Rawal
2014-05-12 21:00     ` Thomas S. Dye
2014-05-13 17:48       ` Vikas Rawal
2014-05-13 18:15         ` John Hendy
2014-05-13 18:40           ` Vikas Rawal [this message]
2014-05-14 14:19             ` Suvayu Ali
2014-05-14 16:02               ` Vikas Rawal
2014-05-13 19:55         ` Thomas S. Dye
2014-05-13 18:01 ` Eric S Fraga
2014-05-13 18:52   ` Vikas Rawal
2014-05-14  3:38     ` Using Emacs, Org-mode and R for Research Writing in Social Sciencess Ken Mankoff
2014-05-14  7:00       ` Vikas Rawal
2014-05-14  9:02         ` Christopher Witte
2014-05-14 10:15           ` Vikas Rawal
2014-05-14 13:23         ` Ken Mankoff
2014-05-14 13:27           ` Vikas Rawal
2014-05-14 13:27           ` Vikas Rawal
2014-05-14 14:07 ` Using Emacs, Org-mode and R for Research Writing in Social Sciences Axel Kielhorn
2014-05-14 16:51   ` Vikas Rawal
2014-05-14 18:39     ` Axel Kielhorn
2014-05-15  4:49       ` Vikas Rawal
2014-05-15  8:18         ` Axel Kielhorn
2014-05-15  8:38           ` Vikas Rawal
2014-05-15 11:57         ` Axel Kielhorn

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=4EAA0890-F121-49D9-B643-9891204F43E5@agrarianresearch.org \
    --to=vikaslists@agrarianresearch.org \
    --cc=emacs-orgmode@gnu.org \
    --cc=jw.hendy@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).