davidam.el: fixed davidam-org-envolve-numbered-list
[worg.git] / worg-about.org
1 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
2 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
3 #+TAGS:       Write(w) Update(u) Fix(f) Check(c) 
4 #+TITLE:      About Worg
5 #+AUTHOR:     Worg people
6 #+EMAIL:      mdl AT imapmail DOT org
7 #+LANGUAGE:   en
8 #+PRIORITIES: A C B
9 #+CATEGORY:   worg
10 #+OPTIONS:   H:3 num:nil toc:t \n:nil ::t |:t ^:t -:t f:t *:t tex:t d:(HIDE) tags:not-in-toc
11
12 [[file:index.org][{Back to Worg's index}]]
13
14 * What is Worg?  What is its relation to Org?
15
16 [[http://www.orgmode.org][Org]] is an [[http://www.gnu.org/software/emacs/][Emacs]] mode for /keeping notes, maintaining to-do lists, and
17 doing project planning with a fast and effective plain-text system/
18 (as the [[http://www.orgmode.org/org.html][Org manual]] says).
19
20 Worg is a /collectively/-built knowledge database about [[http://orgmode.org][Org]],
21 planning in plain text, and other related topics.
22
23 * Why use Org-mode for creating a collaborative website?
24
25 Because Org makes it easy, fast and effective to edit *well-structured*
26 files.  Ever wanted to edit a [[file:org-tutorials/tables.org][table]] in a wiki?  Ever wanted to change the
27 outline structure in a wikipage?  Ever wanted to edit lists quickly?  Org
28 lets you do this.
29
30 Because Org-mode makes *beautiful* documents: it supports links, font
31 beautification, examples, etc.  And you can export those documents to
32 HTML, LaTeX, or DocBook.
33
34 Because Org is also a powerful *task-management system*.  Hopefully sharing
35 a [[file:worg-todo.org][TODO file]] will make it easy for everyone to know where he could help.
36
37 * So Worg is a bit like a wiki, no?
38
39 No.  Yes.  Kind of.  Here are a few differences:
40
41 - you edit the pages *using Emacs*, not a cheesy web interface;
42
43 - the Worg website (repository) is maintained using [[http://git-scm.com/][git]];
44
45 - even if people are invited to merge their changes into the [[http://orgmode.org/worg/][main Worg
46   website]], they are free to start a new Worgie of their own.  Using git
47   makes Worg a *distributed* community website.
48
49 - there is an important difference: Org is a very fast and effective plain
50   text task-management system.  Meaning that you can add the Worg todo
51   file (=worg-todo.org= in the Worg directory) to your =org-agenda-files= and
52   see your list of task populated by tasks added by other people...
53
54 * Who can participate in the editing of Worg?
55
56 Everyone with a minimal knowledge of Org (and Emacs) and git.  See the
57 page describing how to use [[file:worg-git.org][git for editing Worg]] for details.
58
59 * Do I need to register somewhere?
60
61 No.  You just need to send your public key to Jason or Bastien.
62
63 * So what is contained in Worg?
64
65 Everything related to Org, project planning in plain text, and the Org
66 community.  Go crazy!
67
68 * Who's in charge of Worg?
69
70 Worg was started by [[http://www.cognition.ens.fr/~guerry/][Bastien]]
71 in the hope that other Org-ers around will bite into this and start
72 sharing tutorials, example of codes, etc.
73
74 Worg is currently maintained by [[file:users/mlundin.org][Matt Lundin]]. Feel free to [[mailto:mdlATimapmailDOTorg][contact him]] if
75 you have any questions about the site.
76
77 * OK, I want to contribute to Worg now!
78
79 The first thing you need to know is [[file:worg-git.org][how to use git for Worg]].
80
81 The second thing you might be interested in is general advice and
82 conventions on how to [[file:worg-editing.org][let Worg grow]].
83
84 If you're interested in knowing how Worg publishes itself as a website,
85 check the [[file:worg-setup.org][Worg setup]] page.