r9 - /web/howto.mdwn

[adeodato at users.alioth.debian.org]

Author: adeodato
Date: Wed Jan 16 12:15:55 2008
New Revision: 9

URL: http://svn.debian.org/wsvn/dep/?sc=1&rev=9
Log:
Provide a howto document.

Added:
    web/howto.mdwn

Added: web/howto.mdwn
URL: http://svn.debian.org/wsvn/dep/web/howto.mdwn?rev=9&op=file
==============================================================================
--- web/howto.mdwn (added)
+++ web/howto.mdwn Wed Jan 16 12:15:55 2008
@@ -1,0 +1,34 @@
+[[meta title="How to use dep.debian.net for your own proposals"]]
+
+Using dep.debian.net
+====================
+
+You are welcome to maintain your DEP under the _dep.debian.net_
+namespace. This site runs [ikiwiki][] with a Subversion repository
+underneath it, so you will have to:
+
+  1. `svn checkout svn+ssh://svn.debian.org/svn/dep/web`
+  2. commit a file named _depN.mdwn_ under `web/deps`
+
+  [ikiwiki]: http://ikiwiki.info
+
+The file is in Markdown format, which basically means that plain text
+will format nicely, and for extra goodies you can consult [this brief
+help][syntax1], or the full [Markdown syntax documentation][syntax2].
+The only caveat is for the first paragraph: please indent all of its
+lines with 4 spaces, so that it gets treated as <pre>; see e.g.
+[dep0.mdwn][].
+
+  [syntax1]: http://ikiwiki.info/ikiwiki/formatting/index.html
+  [syntax2]: http://daringfireball.net/projects/markdown/syntax
+  [dep0.mdwn]: http://svn.debian.org/viewsvn/*checkout*/dep/web/deps/dep0.mdwn
+
+There is also a [dep-commits mailing list][ml].
+
+  [ml]: http://lists.alioth.debian.org/mailman/listinfo/dep-commits
+
+# TODO
+
+* I think it would be great if we could provide VCSen space for git, hg,
+  bzr, etc. under the _dep_ Alioth project, and have a way for the
+  website to pull from there.