Two months ago, I launched a Make It Happen campaign to build a System Administrator Guide with the goal of migrating the installation, setup, and upgrade documentation out of the wiki and into a beautiful guide on our new documentation platform. Amazingly, the MIH campaign reached its $2,000 USD minimum in only 4 days — which meant I could get to work right away!
Now I've completed this content migration and am excited to share the System Administrator Guide with you, in all its glory...
Before you thank me, join me in thanking these partners and community members who made this project happen by backing the campaign:
Each of these backers made an investment in CiviCRM's documentation, and this investment will continue paying off (for all of us!) by saving system administrators valuable time when maintaining CiviCRM installations. Thanks!!
Now we have a System Administrator Guide!
But of course, it will never be "done" — it will be a living document that many community members will continue to shape for years to come. For the purpose of completing this Make It Happen project, I had to draw the line somewhere and call the project "done". From the start, the goal of this campaign has been to migrate existing installation, setup, and upgrade content from the wiki into guide. But the line around this goal is definitely a bit blurry. So I want to be clear about where I'm stopping...
Aside from the essential work of migrating 82 wiki pages, here are some additional improvements I made along the way:
On the other side of the blurry line, here are some outstanding tasks which have fallen just slightly beyond the scope of the project, as I've chosen to define it:
There are plenty of other open issues as well, but I chose to highlight the two above because they're things I could have reasonably defined as part of this project but chose not to. Gotta draw the line somewhere! I see these tasks as the highest priority work that needs to happen on the Sysadmin Guide right now.
It's also worth pointing out that other people have already jumped in and have been helping out with the Sysadmin Guide. In particular,
Make It Happen is awesome. It worked splendidly for me, and I want to help grow the MIH model among our community. Do you have an idea for a Make It Happen project? I would love to help you get it off the ground! Find me on Mattermost and we can chat.
After all we make fundraising software, so I think we have huge opportunities to do more fundraising for improvements to our product!