Hi, On Thu, 21 Aug 2025 at 22:27, Simon Josefsson via "Development of GNU Guix and the GNU System distribution." <guix-devel@gnu.org> wrote:
>> And yes, documentation on how to set up >> individual build machines specially for ci.guix (in this case) probably >> needs to be written. > > Who could write this documentation? I can volunteer to be a guinnea pig > to try to read the documentation and follow instructions so that a new > ppc64el VM gets setup, so we later can recycle the current one with a > more modern install. However I have a very vague understanding of how > the Guix server-side build system works so I can't help write this. FWIW, I think that the documentation should not be written by the people already overloaded with Infrastructure maintenance but the documentation should be written by people offering their help. Somehow, we have overloaded people that ask help, so we cannot collectively answer: “Please do more work by writing documentation so we can help you.” :-) For sure, there is issues: knowledge bootstrap, history background, etc. as said in [1]. Ok, let be concrete! My proposal: 1. A set of people commit for one or two months in order to write notes and acquire skills about the Infrastructure. I volunteer! :-) 2. People who are maintaining the Infrastructure schedule time to answer the questions of #1. For instance, we could imagine a weekly or bi-weekly “meeting” where #1 and #2 discuss from 30min to 1h about the various configuration files in the various repositories. And these discussions are stored inside notes. The meetings could be scheduled on IRC or on some BigBlueButton. This way, we start some skill transfer and collect materials. Then depending how it goes, we will be able to structure some documentation. The notes are the important part. :-) Because it initiates a virtual circle. Somehow, it avoids the blank page syndrome. It’s rewarding because it provides a concrete base. Etc. WDYT? Who’s in? Cheers, simon 1: Re: Priorities for the coming months Simon Tournier <zimon.touto...@gmail.com> Thu, 21 Aug 2025 14:42:12 +0200 id:87tt20rgm3....@gmail.com https://lists.gnu.org/archive/html/guix-devel/2025-08 https://yhetil.org/guix/87tt20rgm3....@gmail.com
