7

I came across this blog post yesterday, and it once again made me want to give literate programming a try.

Has anyone else tried doing literate programming for C#? I'm wondering about trying Lyx + noweb, but wondered if you might have other experience or suggestions.

Benjol
  • 63,995
  • 54
  • 186
  • 268
  • I don't really "get it".... looks like code with a lot of comments to me :-) – Robert Fraser Jan 15 '10 at 05:56
  • No, it's text with bits of code, check out the blog post linked in the question. I think it is very good for *communicating* code to someone else. Obviously, with no intellisense, no code formatting, no debugger, it's a long shot, but I'd like to try. – Benjol Jan 15 '10 at 07:00
  • Hmm, I have this idea brewing for using markdown for literate programming :) – Benjol Jan 15 '10 at 08:16
  • how are things going with literate programming? have you continued? – Alex Gordon Mar 02 '18 at 21:40
  • For C# there's [LiterateCS](https://github.com/johtela/LiterateCS). Haven't tried it. – Pablo H Sep 20 '21 at 17:42

1 Answers1

4

Get Leo, the outlining editor, and make noweb files. Noweb can make HTML that can be your online documentation and it can make source files that are numbered like your noweb input. You can edit the noweb or the source. If you edit the source, Leo can update your changes back into the noweb file. Noweb can also make TEX files for really pretty printing.

Noweb is so simple its users guide fits on one side of one sheet of paper. Leo is one of those GUI tools you already know how to use ... has lotsa tricks if you want them.

Both are free!

Benjol
  • 63,995
  • 54
  • 186
  • 268
Bill Drissel
  • 186
  • 1
  • 6