prabbit wrote: > ^^^ This. > > Seems like a fairly standard, run-of-the-mill docs-as-code approach. I > applaud this. Given that the structure of the pCP docs is not terribly > large or complex, this approach should be easy to implement and, > importantly, maintain. By hosting it on GitLab I anticipate interested, > docs-minded people can make pull requests and file issues. (Truth be > told, I haven't looked to see if the current project allows PRs for > docs.) > > I'm looking forward to seeing where this Docs As Code approach leads > you. It's the world I live in, although usually working with more > semantically-rich languages than just Markdown, although Markdown has > played a part in some projects I've done.
I wonder if my interpretation of "documentation" matches others' expectations? I was thinking of products that could take someone new to the world of RPis, pCP and Linux through all they need to do to end up with a working system, and without getting any further into stuff like the command line than is absolutely essential. So I had no focus at all on code, only on steps to get from the start to enjoying music. A while back I knocked up a sample web page on how to set up pCP Bluetooth - https://wbeachdave.weebly.com/bt-on-pcp.html (Because I'd had a bit of a struggle to get Bluetooth working the first time I tried to do it, and thought some more documentation might help.) If I get the time, I'll see if I can turn that into a Markdown document. Digital: Raspberry Pi 3B; piCorePlayer 6 + LMS 8; HifiBerry DAC+DSP > Yamaha RX-V2700 > Jamo speakers Analogue: HifiBerry DAC+DSP > Speakercraft MZC-66 > whole house Library: External USB drive Android: Squeezer app ------------------------------------------------------------------------ Viragored's Profile: http://forums.slimdevices.com/member.php?userid=32954 View this thread: http://forums.slimdevices.com/showthread.php?t=112712 _______________________________________________ unix mailing list [email protected] http://lists.slimdevices.com/mailman/listinfo/unix
