summaryrefslogtreecommitdiff
path: root/templates/pages/development.mako
diff options
context:
space:
mode:
Diffstat (limited to 'templates/pages/development.mako')
-rw-r--r--templates/pages/development.mako51
1 files changed, 50 insertions, 1 deletions
diff --git a/templates/pages/development.mako b/templates/pages/development.mako
index 20fc521..20d8054 100644
--- a/templates/pages/development.mako
+++ b/templates/pages/development.mako
@@ -1,7 +1,56 @@
<%!
title = "Development"
+ uses_toc = True
%>
<%inherit file="/page.mako" />
<p>
-Developers, Developers, Developers
+ If you want to have a look at the sourcecode, or even support the development with patches or similar, you are now on the correct page :).
+</p>
+
+${self.toc()}
+
+<%self:h2>Getting the source</%self:h2>
+<p>
+ Portato's sourcecode is managed with <a href="http://www.git-scm.com/">Git</a> (<strong>dev-vcs/git</strong>) and is hosted on <a href="http://github.com/Necoro/portato">GitHub</a> and <a href="http://git.necoro.eu/portato.git/">on this very server</a>. So you can chose the one you want to clone from:
+</p>
+<%self:hl lang="bash">
+# either this
+git clone git://github.com/Necoro/portato.git
+
+# or that
+git clone git://necoro.eu/portato.git
+</%self:hl>
+<p>
+ You now should have a subdirectory <em>portato/</em>, which contains the sources. If you want to update it to reflect upstream changes, do:
+</p>
+<%self:hl lang="bash">
+git pull
+</%self:hl>
+<p>
+ Sometimes you need to work on a specific version (for instance if you are <a href="/translating">translating</a>). Then you need to check out the specific version branch:
+</p>
+<%self:hl lang="bash">
+# replace '0.13' by the version you need
+git checkout -b 0.13 origin/0.13
+</%self:hl>
+<p>
+ For further information have a look at the <a href="http://www.git-scm.com/documentation">Git documentation</a> or search the webs. There are plenty of sources and guides out there.
+</p>
+
+<%self:h2>Filing a bug</%self:h2>
+<p>
+ You can do this in the <a href="/r/bugs">bugtracker</a>.
+</p>
+
+<%self:h2>Documentation</%self:h2>
+<p>
+ The code itself is documented (sometimes ^^). If you have questions, you can ask them via portato@necoro.net.
+</p>
+<p>
+ The software itself is not documented in any way. If you like to change this, drop me a mail :). I'd be glad.
+</p>
+
+<%self:h2>Wiki/Mailing-list/...</%self:h2>
+<p>
+ Not there (yet?). Are they really necessary?
</p>