worg-about.org 3.4 KB

What is Worg? What is its relation to Org?

Org is an Emacs mode for /keeping notes, maintaining to-do lists, and doing project planning with a fast and effective plain-text system/ (as the Org manual says).

Worg is a /collectively/-built knowledge database about Org, planning in plain text, and other related topics.

Why use Org-mode for creating a collaborative website?

Because Org makes it easy, fast and effective to edit *well-structured* files. Ever wanted to edit a table in a wiki? Ever wanted to change the outline structure in a wikipage? Ever wanted to edit lists quickly? Org lets you do this.

Because Org-mode makes beautiful documents: it supports links, font beautification, examples, etc. And you can export those documents to HTML, LaTeX, or DocBook.

Because Org is also a powerful task-management system. Hopefully sharing a TODO file will make it easy for everyone to know where he could help.

So Worg is a bit like a wiki, no?

No. Yes. Kind of. Here are a few differences:

  • you edit the pages using Emacs, not a cheesy web interface;
  • the Worg website (repository) is maintained using git;
  • even if people are invited to merge their changes into the [[https://orgmode.org/worg/][main Worg
  • website]], they are free to start a new Worgie of their own. Using git makes Worg a *distributed* community website.
  • there is an important difference: Org is a very fast and effective plain
  • text task-management system. Meaning that you can add the Worg todo file (=worg-todo.org= in the Worg directory) to your =org-agenda-files= and see your list of task populated by tasks added by other people...

Who can participate in the editing of Worg?

Everyone with a minimal knowledge of Org (and Emacs) and git. See the page describing how to use git for editing Worg for details.

Do I need to register somewhere?

No. You just need to send your public key to Jason or Bastien.

So what is contained in Worg?

Everything related to Org, project planning in plain text, and the Org community. Go crazy!

Who's in charge of Worg?

Worg was started by Bastien in the hope that other Org-ers around will bite into this and start sharing tutorials, example of codes, etc.

Worg is currently maintained by Matt Lundin. Feel free to contact him if you have any questions about the site.

OK, I want to contribute to Worg now!

The first thing you need to know is how to use git for Worg.

The second thing you might be interested in is general advice and conventions on how to let Worg grow.

If you're interested in knowing how Worg publishes itself as a website, check the Worg setup page.