[Xerte-dev] Re: Documentation process

[Julian Tenney]

Do you have a github username? I’ll add you as a collaborator.

From: xerte-dev-bounces at lists.nottingham.ac.uk [mailto:xerte-dev-bounces at lists.nottingham.ac.uk] On Behalf Of Mark Berthelemy
Sent: 21 November 2013 15:53
To: For developers
Subject: [Xerte-dev] Documentation process

Hi all,

Rather than setting up a separate wiki for documentation, I'd like to investigate using a sub-repository on Github which is then incorporated into the main Xerte codebase as /docs.

The sub-repository would use the Github wiki as its source, so can easily be edited online.

The files are in markdown format, so I'll look at adding markdown support via a PHP markdown interpreter, so they can be viewed locally.

This approach would allow us to make sure that each release of XOT has a valid, version-controlled set of documentation attached to it.

Useful references:

http://brendancleary.com/2013/03/08/including-a-github-wiki-in-a-repository-as-a-submodule/

Can anyone suggest a reason for not going down this route?

Mark

--
Mark Berthelemy
Managing Director
Tel:      01773 318 962
Mob:    07922 146 761
Web:    www.wyversolutions.co.uk<http://www.wyversolutions.co.uk>

Wyver Solutions Ltd | Company number: 5731173 Registered in England | Registered address: First Floor, 6 Bridge Street, Belper, Derbyshire, DE56 1AX

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.nottingham.ac.uk/pipermail/xerte-dev/attachments/20131121/455ea4e6/attachment.html>