https://projects.ecoinformatics.org/ecoinfo/https://projects.ecoinformatics.org/ecoinfo/ecoinfo/favicon.ico?14691340362010-07-07T01:40:45ZEcoinformatics RedmineKepler - Bug #5069: The ability to create user manuals from a wiki that is continuously updated.https://projects.ecoinformatics.org/ecoinfo/issues/5069?journal_id=175502010-07-07T01:40:45ZChristopher Brookscxh@eecs.berkeley.edu
<ul></ul><p>I agree that making it easier for developers to update documentation is an<br />excellent goal. However, it is fairly difficult to do and requires quite<br />a bit of effort.</p>
<p>I'm not so sure wiki pages are the right solution because wiki pages heavily<br />hyperlinked and dependent on being on-line. Edward Lee is working on a system<br />that uses LaTeX to generate pdfs that are suitable for printing or for viewing<br />on a computer. The computer viewable pdfs have links to JNLP versions of<br />Ptolemy models. There are likely other online systems that generate printable<br />files and on-line files.</p>
<p>Moving away from Word to LaTeX or anything else would be preferred. A review<br />of what's out there would be a good start.</p>
<p>To close this feature request, we would need a system that would generate<br />something like the current Kepler printed documentation. Such a system<br />should be easy for developers to use. Ideally, it would use pre-existing<br />software as opposed to being developed in-house.</p>
<p>I'm marking this as an enhancement and estimating 200 hours, feel free<br />to change.</p> Kepler - Bug #5069: The ability to create user manuals from a wiki that is continuously updated.https://projects.ecoinformatics.org/ecoinfo/issues/5069?journal_id=175512010-07-14T17:24:56ZMatt Jonesjones@nceas.ucsb.edu
<ul></ul><p>LT discussion: this is important, should probably be in a more standard markup like LaTeX or RST, and we can generate wiki content from that (rather than the other way around).</p> Kepler - Bug #5069: The ability to create user manuals from a wiki that is continuously updated.https://projects.ecoinformatics.org/ecoinfo/issues/5069?journal_id=175522010-07-22T17:52:29Zben leinfelderleinfelder@nceas.ucsb.edu
<ul></ul><p>1 vote for LaTex:<br />Jim Regetz and I converted the Morpho user guide from Word to LaTex - seems much more manageable than the Word version. We've not looked into generating online materials (other than a PDF).</p> Kepler - Bug #5069: The ability to create user manuals from a wiki that is continuously updated.https://projects.ecoinformatics.org/ecoinfo/issues/5069?journal_id=175532013-03-27T21:29:06ZRedmine Admin
<ul></ul><p>Original Bugzilla ID was 5069</p>