Marc Skov Madsen

> (Once again, I've gone back and forth reviewing this, in light of Demetris' comment) > > I gave another good read to Diataxis' docs, focusing on tutorials. It took...

> It's based on https://matthewrocklin.com/blog/work/2020/07/13/brevity > > I think we can simply remove the recap section, and keep the table of contents above. ha ha. Its hard to keep sane...

I can read that *In this section you will learn ...* somehow is not respectful. I don't understand it. But maybe its because English is a 2nd language for me....

Please also if you can. Comment at specific line in file. Because those comments can be "resolved". Its much easier to keep track of.

> I don't think it's disrespectful; it's just a matter of keeping it direct by dropping filler words. I do not get that impression when looking up 

Thanks all for the feedback. It takes time to digest :-) I've tried to start using it. I've updated and adapted the `index`, `build_chatbot` and `build_report` tutorials so far. The...

You can see how difficult it is. The django tutorials from which Diataxis was born as a long, bulleted list in the beginning.  I think that is too much...

I'm currently reflecting a bit on the "narrative" push back. My idea is that there is a narrative in the Wind Turbine dataset that Phillip used for one of the...

This is a narrative proposed by chatGPT. --- Creating a collection of tutorials for HoloViz Panel that takes users from zero to hero with a common narrative around wind turbine...

> I would ask it to elaborate concisely or update the details of each section to reflect the narrative. I'm not sure I understand. What question would you ask chatGPT?