A few months back In the smoke-filled (virtual) room of the council of the high (from the smoke) elves, the wizened textualist Geoff, said “All of my stuff is in boxes and containers.” Empty shelves behind him indicated he was moving house. “When you have a complex module,” Geoff continued, “and its difficult to describeContinue reading “Day 22 – Wrapping a Christmas Present”
Tag Archives: documentation
Day 12 – Perspectives on RakuDoc Version 2
Just in time for Christmas This project started with the modest aim of documenting parts of Rakudoc V1 (what used to be called POD6 that had been specified, but not included in the original documentation. Except … some parts of the specification had not been implemented in the Pod::To::HTML renderer. And some parts were outdated. So aContinue reading “Day 12 – Perspectives on RakuDoc Version 2”
Day 6 – The Future Of POD6
by Kay Rhodes Some people believe that “code should be self documenting”. They believe that we don’t need inline docs because you can just look at the code and see what it’s doing. The reality is that everyone’s brain works differently. Everyone processes new information differently. My brain’s extra divergent. I have a working memoryContinue reading “Day 6 – The Future Of POD6”
Raku Advent Calendar