This Time Self-Hosted
dark mode light mode Search

Patches and documentation

Okay, if someone is monitoring my CIA stats, lately I started committing more on project pages and gentoo/src repository. I’m trying to provide documentation for what I do, and how I do it, allowing someone else to take care of my tasks if I’m going away. The reason of this is that I really think that time spent on writing process documentation is not wasted, but employed in a productive way.

For this reason now the patchsets are available on the CVS like gcc’s or binutil’s, instead of my local SVN repo. I also changed quite all the occurrence of my homepage on the tree with mirror://gentoo/ and I’m waiting on a sort of half-automatic script that allows me to put the patchsets on my site only for the time requested to them to get into mirrors.

I’m also working on at least three maintainer’s guides: ALSA, xine and VLC. These are the main packages I maintain on sound and video herds, so they are there with all the data I could find on them. There are other packages I maintain such as netatalk, bsdtar and libiconv but they don’t belong there so I don’t really know where to write them ๐Ÿ˜ Maybe I can add bsdtar and libiconv in gentoo/alt or gentoo/bsd.
It’s a bit unorganized this way, I know. But I don’t think there would be space for a “maintainers’ guides” project ๐Ÿ™‚ I really hope other devs would start writing similar documentation, tho, as it really helps when someone else have to take care of task of older devs.

I also thought about writing a quilt tutorial, but I’m not really that good, and it would require to go through the GDP probably, so it needs to be written by someone who knows English better than me ๐Ÿ˜›

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.