I do appreciate the arguments that footnotes can be distracting, or that one doesn't know whether to skip them, but at present I see them as the best option for keeping the main body streamlined/as short as possible without sacrificing points that I'd like to make that wouldn't make for or fit into an appendix.
> Avoid placing equations in the middle of sentences. Mathematics is not the same as English, and we shouldn’t pretend it is.
I don't know what to make of it. Equations are supposed to be part of sentences, and mathematical equations are compact expressions of relations. For example, the sentence,
Newton taught us that force is equal to mass times acceleration, where both mass and accelerations are inertial quantities.
can be compacted as Newton taught us that $F=ma$, where both the mass $m$ and acceleration $a$ are inertial quantities.
This becomes more useful with more complex relations. Generally, hanging mathematical expressions (those independent of sentences) should be avoided to the utmost in any technical report.The authors are biologists, so I suspect they're not particularly versed in mathematical writing (and that McCarthy was not likely providing them much advice on it).
> Keep sentences short, simply constructed and direct. Concise, clear sentences work well for scientific explanations. Minimize clauses, compound sentences and transition words — such as ‘however’ or ‘thus’ — so that the reader can focus on the main message.
Repetitive sentence structure is not engaging and lulls a reader to sleep, no matter the context. Clauses and transition words and nontrivial sentence structure allow for qualification and clarification, juxtaposition and contrast, and emphasis, often with many fewer words than if written as a series of single independent clauses. A short sentence following longer ones punctuates its point and can effectively lead into subsequent sentences that express more complex ideas/explanations.
In my own scientific writing I also frequently use compound sentences to indicate that the ideas are related (causally or otherwise). It's also unclear to me how one could more efficiently communicate logical or causal flow between ideas than with transition words like "thus" or "therefore."
> Commas denote a pause in speaking.... Speak the sentence aloud to find pauses.
made its way into this article. Hard to imagine that this particular point, to which I might attribute many of the comma splices I see in scientific writing, actually came from a professional writer.
Habitually running restart and run all works okay for very lightweight notebooks, but it's a habit you need to develop, and I believe our tools should work by default. It doesn't work at all for entire categories of work, where computation is heavy and the cost of a bug is high.
From the blog, you will see that reactive execution not only minimizes hidden state, it also enables rapid data exploration (far more rapid than a traditional notebook), reuse as data apps, reuse as scripts, a far more intelligent module autoreloader, and much more.
marimo is not just another Jupyter extension, it's a new kind of notebook. While it may not be for you, marimo has been open source for over a year and has strong traction at many companies and universities, including by many who you may not view to be "real devs". The question of whether marimo will catch on has already been resolved :)