News for hackers. Stuff that matters.
Re:Nbdev: A literate programming environment that democratiz... by nestorD on Friday November 20, 2020 @05:07PM (#25165643)
I have used Nbdev and I am not a fan. It creates friction when one wants to contribute (in my case, to fast.ai) and forces you to write your code with notebooks which is the point but also not great when you are writing code rather than producing a display mixing text and pictures. Plus, while notebooks should favour documentation in theory, you can also end up with notebooks full of blob of code with transitions text that does not help you undertsanding what's going on.

Case in point, here is a random notebook from the fastai repository, a python file would be simpler to read and shorter: https://github.com/fastai/fastai/blob/master/nbs/09b_vision....

Re:Nbdev: A literate programming environment that democratiz... by ElevenPhonons on Friday November 20, 2020 @06:43PM (#25166510)
It seems like there's a lot of friction points with this model and perhaps a bit too much world building. In general, I have trouble understanding the allure of this approach.

Another example (and bonus points if you can spot the rogue semicolon).

https://github.com/fastai/fastcore/blob/master/nbs/02_founda...

https://github.com/fastai/fastcore/blob/master/fastcore/foun...

https://fastcore.fast.ai/foundation.html