Hi,<div><br></div><div>I would be happy to contribute in any way that I can, though that might be more reading, testing and commenting on documentation rather than producing new pieces for 'core' cctbx tasks.</div>
<div><br></div><div>I use Google Docs/Drive for my own notes, but find it inadequate for any form of polished documentation. The equation editor started off well, being a simple text input field that rendered LaTeX markup, but they scrapped that for a graphical Word style editor that was an enormous step backwards in my opinion. It has improved slightly since then, accepting some LaTeX-like shortcut keys like '_' and '^' for sub- and superscript, but still lacks certain symbols, and the inter-operability with LaTeX that it once had. Also, Google has occasionally changed their Docs engine, requiring me to 'upgrade' my documents to the latest version, which has invariably mangled some of the formatting. For these reasons, much as I like Google Docs for convenience, I would strongly recommend avoiding it for the purpose in mind.</div>
<div><br></div><div>Some form of simple and concise markup language seems most appropriate. I use LaTeX, but arguably it fails on both of these requirements. Also, the mess of�packages on�CTAN, many of which are mutually incompatible, make portability and concatenation of documents a real pain. Some of the obscure documentation for these packages really makes advanced LaTeX use feel like alchemy.</div>
<div><br></div><div>I briefly explored reStructuredText a while ago, but concluded that it was great for code blocks, but didn't have rich enough math rendering capabilities. Now, revisiting the documentation I wonder if I was wrong? I would like to be able to do vectors and matrices, equation arrays with control over which lines are numbered, and labels to refer to equations in the text. If this is covered easily by reStructuredText then I nominate it as a serious contender.</div>
<div><br></div><div>Cheers</div><div class="gmail_extra"><br></div><div class="gmail_extra"><div>-- David<br></div><br>
<br><br><div class="gmail_quote">On 11 December 2012 09:33, Luc Bourhis <span dir="ltr"><<a href="mailto:luc_j_bourhis@mac.com" target="_blank">luc_j_bourhis@mac.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="word-wrap:break-word">Hi Pavel,<div><br></div><div>I agree 100% with everything you said.<div class="im"><br><div><br><blockquote type="cite"><span style="border-collapse:separate;font-family:'Lucida Sans';font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;font-size:medium">I have zero experience with Google Docs, so these couple of questions are rather out of my ignorance. Does it allow to 1) insert formulas, 2) put pieces of code that can be extracted automatically for exercising ?<br>
</span></blockquote><br></div></div><div>I would recommend using ReStructureText as we did for the Comp. Comm. news letter and put the file on our Sourceforge repo of course.</div><div><br></div><div>Best wishes,</div><div>
<br></div><div>Luc</div><div><br></div><br></div></div><br>_______________________________________________<br>
cctbxbb mailing list<br>
<a href="mailto:cctbxbb@phenix-online.org">cctbxbb@phenix-online.org</a><br>
<a href="http://phenix-online.org/mailman/listinfo/cctbxbb" target="_blank">http://phenix-online.org/mailman/listinfo/cctbxbb</a><br>
<br></blockquote></div><br></div>