|
|
The basic idea is that Literate UpDown is readable in its own right as a text file and can serve as an active document, in that it can be operated in various ways. The Literate UpDown file could also be employed in a rich viewer or rich text editor for more convenient presentation. There should be straightforward translation to web page(s).
Another use of Literate UpDown is as markup within the source code of a computer program. This raises some peculiar problems if redundancy with structures already visible in the code is to be avoided. That means the code is being annotated and that makes extraction of a document above the code more problematic.
The principle design point is that programmers should be able to begin producing Literate UpDown starting with familiar structures in code, and that collaborative development of open-source projects could employ Literate UpDown without creating barriers to entry for participants or excessive friction for developers. In that respect, some of the motivations of noweb are applicable.
A second design point is having a means to accomplish Systematic Program Design using programming languages such as C/C++ and Java, even though the edit-compile-execute cycle is longer.
It seems very easy to re-invent the wheel and also arrive at a duplicative dead end. To counter that, there will be an effort to avoid premature generalization and use versioning and care to work from the least that can possibly work.
- n131101b: Literate Updown Approach [latest material]
- n131101c: Literate Updown Considerations
- n131101a: Diary & Job Jar
- Kiczales, Gregor. Introduction to Systematic Program Design - Part 1. On-Line Course. Coursera. Synopsis at <https://www.coursera.org/course/programdesign> accessed 2013-11-11-10:28.
- Knuth, Donald E. ‹‹Literate Programming››. CSLI Lecture Notes Number 27, Center for the Study of Language and Information (Stanford, CA: 1992). ISBN 0-937073-80-6 pbk.
- literateprogramming.com. Web site on CWEB and Literate Programming resources. <http://www.literateprogramming.com>. Accessed 2013-11-11-09:57.
- Ramsey, Norman. Noweb -- A Simple, Extensible Tool for Literate Programming. Noweb home page, <http://www.cs.tufts.edu/~nr/noweb/>, accessed 2013-11-11-09:14
- Wikipedia. Literate Programming, article at <http://en.wikipedia.org/wiki/Literate_programming>. 2013-10-06-07:34 version accessed 2013-11-11-09:00.
- Hamilton, Dennis E.
- Literate UpDown. nfoWare nfoNote folio n131101 0.01, November 11, 2013. Accessed at <http://nfoWare.com/notes/2013/11/n131101.htm>.
|
|
created 2013-11-08-14:06 -0800 (pst) by
orcmid |
