Fork me on GitHub
#docs
<
2017-12-28
>
drewverlee20:12:59

Thanks! I should have looked harder…

drewverlee20:12:34

@arrdem You have given a lot more though to documentation then i have. I was curious if you might have any feedback on an idea i have had that i sketched up here: https://github.com/drewverlee/narrative

arrdem20:12:54

@drewverlee cool! I'm flying in a minute here but I'll definitely get back to you. I agree largely with your premises that the narrative and goals are important and capturing those is definitely something I have in mind with stacks. Was talking with @arohner about this today and that's arguably more important than the code or generated docs. Don't particularly think that essays or artifact commentary belong in the code tho.

drewverlee20:12:18

> Don’t particularly think that essays or artifact commentary belong in the code tho. I’ll need to think about that more, my gut agrees with you, its possible i can get the same effect another way with less coupling between documentation and business code (which i agree is a con).

arrdem20:12:47

Yeah that was kinda Allan's argument today - the code is incidental and it's particular behavior is aspirational towards some actual goal(s)

drewverlee21:12:57

> Allan’s argument today I think im missing some context. Who is Allan?

seancorfield21:12:11

Allan Rohner -- the @arohner mentioned above.

arrdem20:12:21

Particularly for business systems not libraries