After living with RakuDoc v2 for over a year, some things become normal that surprise others when I explain them. Here are a few things I do when documenting my software. 1. Shoving stuff down the file There are a couple of items needed in a changing document that should be easily managed, probably atContinue reading “Day 14 – Playing around with the new documentation components”
Tag Archives: rakudoc
Day 1 – Rendering down for Christmas
Last Christmas we got a new specification for RakuDoc, and this Christmas we have a generic rendering engine for RakuDoc V2. “So what?” some may say. “So WHAT !! ?? !!” shouts an inner demon of mine, having struggled for a year to get all the new stuff working, and wasting weeks on getting escapingContinue reading “Day 1 – Rendering down for Christmas”
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 