I've been ignoring the Live Editor for a while, because most of my programming is done using classes and functions rather than scripts. However, I ran across articles on Literate programming, and they convinced me that there was real value in programming as a document. Also, I struggle with documenting my code (get it working, and worry about documentation tomorrow...), and the Live Editor seemed like a good fix for that.
As a test project, I took one of my functions, converted it to a live function, converted all the comments to Text, and added additional documentation and formatting (bold headers, etc). On the whole, I like the result - however, I find that the interspersal of text with code blocks tends to obscure the indentation levels. There are clearly some steps which can be taken to make the indentation clearer. I've decided that it's good practice to end a live code block (between text areas) on the same indent level that you entered at.
I'm going to do a for loop
yadda;
yadda;
for idx = 1:5
dothis;
dothat;
insert explanation for next step
otherstuff;
end
doNextStep;
is confusing. Better to split it up like:
I'm going to do a for loop. discussion of all the stuff the for loop is going to do
yadda;
yadda;
for idx = 1:
dothis;
dothat;
otherstuff;
end
finished with the for loop, explanation of all the next steps
This is helpful, but I feel that the indent structure would be clearer if I could set the live editor text to indent paragraphs to the same level as the code. It looks like I can set the indent of the first line of a paragraph to match the code, but following lines revert to the left edge.
