So, what does #LiterateDevelopment look like, now?
Well, it bears repeating that the *literate* part (which Robert C Martin would still call "code") should be committed to trunk. It needs to describe implementation, maintenance, testing, deployment, and all the same dimensions of utility documentation has always served.
But now, it needs to be on trunk, not in a separate repo or wiki.
Is that awkward? But we have the tools and many ways to do it, and we're just getting started.
This is what I am learning now. How best to maintain project management docs, specifications, tickets, and so on, on trunk.
I started out putting it in a separate branch and committing generated code to its own branch, and merging. I thought my prompting and writing was just for me, or at least, not what people would want to see.
#LiterateDevelopment #CleanCode
I have realized the error of my ways. The docs are the code. The English is the important part, now.
How are you doing it?