<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 14 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:Helvetica;
panose-1:2 11 6 4 2 2 2 2 2 4;}
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
{font-family:"\@SimSun";
panose-1:2 1 6 0 3 1 1 1 1 1;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
p
{mso-style-priority:99;
mso-margin-top-alt:auto;
margin-right:0cm;
mso-margin-bottom-alt:auto;
margin-left:0cm;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
p.MsoAcetate, li.MsoAcetate, div.MsoAcetate
{mso-style-priority:99;
mso-style-link:"Balloon Text Char";
margin:0cm;
margin-bottom:.0001pt;
font-size:8.0pt;
font-family:"Tahoma","sans-serif";}
span.apple-tab-span
{mso-style-name:apple-tab-span;}
span.BalloonTextChar
{mso-style-name:"Balloon Text Char";
mso-style-priority:99;
mso-style-link:"Balloon Text";
font-family:"Tahoma","sans-serif";}
span.EmailStyle21
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-GB link=blue vlink=purple><div class=WordSection1><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>done<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><b><span lang=EN-US style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>From:</span></b><span lang=EN-US style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'> xerte-dev-bounces@lists.nottingham.ac.uk [mailto:xerte-dev-bounces@lists.nottingham.ac.uk] <b>On Behalf Of </b>Mark Berthelemy<br><b>Sent:</b> 21 November 2013 16:08<br><b>To:</b> For Xerte technical developers<br><b>Subject:</b> [Xerte-dev] Re: Documentation process<o:p></o:p></span></p><p class=MsoNormal><o:p> </o:p></p><div><p class=MsoNormal><span style='font-size:10.0pt;font-family:"Helvetica","sans-serif"'>Yep. It's berthelemy.<o:p></o:p></span></p><div><p class=MsoNormal><span style='font-size:10.0pt;font-family:"Helvetica","sans-serif"'><o:p> </o:p></span></p></div><div><p class=MsoNormal><span style='font-size:10.0pt;font-family:"Helvetica","sans-serif"'>Mark<o:p></o:p></span></p></div></div><div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>-- <o:p></o:p></p></div><div><p class=MsoNormal>Mark Berthelemy<o:p></o:p></p></div><div><p class=MsoNormal>Managing Director<o:p></o:p></p></div><div><p class=MsoNormal>Tel:<span class=apple-tab-span> </span>01773 318 962<o:p></o:p></p></div><div><p class=MsoNormal>Mob:<span class=apple-tab-span> </span>07922 146 761<o:p></o:p></p></div><div><p class=MsoNormal>Web:<span class=apple-tab-span> </span><a href="http://www.wyversolutions.co.uk">www.wyversolutions.co.uk</a><o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Wyver Solutions Ltd | Company number: 5731173 Registered in England | Registered address: <span style='font-size:10.0pt'>First Floor, 6 Bridge Street, Belper, Derbyshire, DE56 1AX</span><o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div></div><p><span style='color:#A0A0A8'>On Thursday, 21 November 2013 at 16:00, Julian Tenney wrote:<o:p></o:p></span></p><blockquote style='border:none;border-left:solid windowtext 1.0pt;padding:0cm 0cm 0cm 8.0pt;margin-left:0cm;margin-top:5.0pt;margin-bottom:5.0pt'><div><div><div><p style='margin:0cm;margin-bottom:.0001pt'><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>Do you have a github username? I’ll add you as a collaborator.</span><o:p></o:p></p><p style='margin:0cm;margin-bottom:.0001pt'><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'> </span><o:p></o:p></p><p style='margin:0cm;margin-bottom:.0001pt'><b><span lang=EN-US style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>From:</span></b><span lang=EN-US style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'> <a href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk">xerte-dev-bounces@lists.nottingham.ac.uk</a> [<a href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk">mailto:xerte-dev-bounces@lists.nottingham.ac.uk</a>] <b>On Behalf Of </b>Mark Berthelemy<br><b>Sent:</b> 21 November 2013 15:53<br><b>To:</b> For developers<br><b>Subject:</b> [Xerte-dev] Documentation process</span><o:p></o:p></p><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p><div><p style='margin:0cm;margin-bottom:.0001pt'>Hi all, <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>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.<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>The sub-repository would use the Github wiki as its source, so can easily be edited online.<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>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.<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>This approach would allow us to make sure that each release of XOT has a valid, version-controlled set of documentation attached to it.<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Useful references:<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'><a href="http://brendancleary.com/2013/03/08/including-a-github-wiki-in-a-repository-as-a-submodule/">http://brendancleary.com/2013/03/08/including-a-github-wiki-in-a-repository-as-a-submodule/</a><o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Can anyone suggest a reason for not going down this route?<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Mark<o:p></o:p></p></div><div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>-- <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Mark Berthelemy<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Managing Director<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Tel: 01773 318 962<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Mob: 07922 146 761<o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Web: <a href="http://www.wyversolutions.co.uk">www.wyversolutions.co.uk</a><o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'>Wyver Solutions Ltd | Company number: 5731173 Registered in England | Registered address: <span style='font-size:10.0pt'>First Floor, 6 Bridge Street, Belper, Derbyshire, DE56 1AX</span><o:p></o:p></p></div><div><p style='margin:0cm;margin-bottom:.0001pt'> <o:p></o:p></p></div></div></div></div><div><div><p class=MsoNormal>_______________________________________________<o:p></o:p></p></div><div><p class=MsoNormal>Xerte-dev mailing list<o:p></o:p></p></div><div><p class=MsoNormal><a href="mailto:Xerte-dev@lists.nottingham.ac.uk">Xerte-dev@lists.nottingham.ac.uk</a><o:p></o:p></p></div><div><p class=MsoNormal><a href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev">http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev</a><o:p></o:p></p></div></div></div></blockquote><div><p class=MsoNormal><o:p> </o:p></p></div></div></body></html>