[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Looking for an advocate



Re: Shachar Shemesh in <[🔎] 421B94FB.1040903@shemesh.biz>
> As someone who has only recently tried to scale the "new developer" 
> documentation, I can tell you that there is room for improvement. I have 
> been going over those docs several times in the past few days, and each 
> time I find myself lost in front of a page full of links embedded inside 
> text, looking for the right doc I know is there, because I read it in 
> the past.

Speaking as someone who recently passed the NM queue (I'm waiting for
DAM approval), I can say that the best way to get used to all stuff is
to just use it. I've been using Debian for several years now, and have
been hanging around in Debian-related IRC channels where you just see
all sorts of packaging stuff/buildd failures/policy issues/bug
reports/whatever all day, so after some time you just "know" it. When
I finally decided to apply for NM, I already had some half a dozend
packages in the archive and didn't have to read many documents since I
either knew the answer myself or knew where to look. (There's the
policy, the developers reference, and a handful of HOWTOs that I
either stumbled over previously or were found by Google quickly.)

I'm not saying that there's no room for improvement, but the
newmaint-guide should give enough head start that everything else will
just become a "less $right_filename" over the time after you've
created your first package. After all, Debian is so complex that you
can't expect to learn "everything" by reading a handfull of documents
in a short time.

> [...] Frankly, I can empathize with his mistake. After all, I clean 
> forgot to to file an ITP in the BTS for wnpp for my package...
> 
> P.S.
> For those so versed in the jargon soup that the last sentence did not 
> sound strange to them, it was supposed to be ironic (despite being 
> factually true).

It didn't sound strange, but I know what you mean nonetheless ;)

Christoph
-- 
cb@df7cb.de | http://www.df7cb.de/

Attachment: signature.asc
Description: Digital signature


Reply to: