Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by yjftsjthsd-h on Thursday November 07, 2019 @07:41AM
(#21472651)
Oh, nice: props for including precise, fully worked example commands to actually use this. This is so helpful in terms of onboarding and being able to actually get people to use a project:)
[ Parent
| on HN ]
Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by bloopernova on Thursday November 07, 2019 @09:23AM
(#21473396)
If I was an eccentric billionaire, I'd reward good documentation with an open source doc prize.
It's so difficult to impress upon some people just important documentation is. And when they do it, they half-ass it by copying stuff from source code and not adding any context.
Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by gigatexal on Thursday November 07, 2019 @03:13PM
(#21476850)
+100 to this. I’ve become a cheerleader for some projects just because the documentation was so good that it was easy to get started. It’s how I became a ZFS zealot among other things.
Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by voltagex_ on Thursday November 07, 2019 @05:28PM
(#21477981)
OT: where do you find the good ZFS documentation? Googling always seems to turn up Oracle's documentation, which may not match what's in FreeBSD or ZFS-on-Linux
Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by stock_toaster on Thursday November 07, 2019 @07:15PM
(#21478888)
The zfs man pages (at least on FreeBSD) are actually pretty decent for finding command usage.
The FreeBSD handbook[1] covers some typical usages.
Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by gigatexal on Friday November 08, 2019 @10:29AM
(#21483048)
To be fair -- the docs for ZFS via the manpage are great but I found a lot of help also from forums of likeminded folks -- ServeTheHome (https://servethehome.com) is where I got hooked.
And then there are countless GitHub projects where the README.md file, which is usually first thing I read, that is super well documented and written for the noob (imo). The best example of that so far, especially for someone like me just getting started with the framework, is the gin Golang http framework: (https://github.com/gin-gonic/gin) -- that readme is full of useful examples.
Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by antpls on Saturday November 09, 2019 @07:11AM
(#21491052)
Google does something similar: https://developers.google.com/season-of-docs/docs
Re:Show HN: microvm – a minimalist machine type for QEMU ins...
by loudmax on Thursday November 07, 2019 @03:35PM
(#21476996)
I sure wish qemu were better documented. There's a lot of qemu documentation out there, but much is incomplete or out of date. A lot of Red Hat's documentation is virsh rather than qemu/kvm. It's fairly easy to get something simple up and going, but there are shortcomings when you try to do something more complicated.