Hi, On Fri, Jun 28, 2019 at 10:37:58AM +0200, Michael Kesper wrote: > Hi Boyuan, > > On 27.06.19 21:38, Boyuan Yang wrote: > [I'm also not sure what's the best mailing list for discussing this, devel, > doc, mentors?] > > > I noticed that for all bug reports that orphan a package in Debian, a semi- > > standard paragraph of words will be provided like this: > > > > ======== > > > > ...Maintaining a package requires time and skills. Please only adopt this > > package if you will have enough time and attention to work on it. > > > > If you want to be the new maintainer, please see > > https://www.debian.org/devel/wnpp/#howto-o for detailed > > instructions how to adopt a package properly.... > > > > ======== > > > > However, https://www.debian.org/devel/wnpp/#howto-o provides almost zero > > information for an enthusiast that want to adopt the package, i.e. there's > > no > > detailed instruction on how to actually upload a package for a person not > > quite familiar with Debian's packaging workflow. > > > > I'd suggest some kind of rewording on the website given that this link has > > been posted everywhere in different BTS bug reports. Including a link to > > https://mentors.debian.net/intro-maintainers might be a good idea. Anyway > > any > > kind of improvement would be appreciated. > > That's a very good point you spotted there. > This text actively discourage people from doing work and gives them no > pointers > to information re the "requred time and skills" would be.
I agree. > That clearly should be improved, maybe: > > Maintaining a package requires time and skills. > Please have a look at https://mentors.debian.net/intro-maintainers > for getting started. > > [and intro-maintainers should at first feature some welcoming words and then > the right documentation for beginners (is that > https://www.debian.org/doc/manuals/debmake-doc/index.en.html or Yes. > https://www.debian.org/doc/manuals/maint-guide/index.en.html ?) No since I don't want to maintain 2 of them forever. If you see some important tutorial contents are missing in debmake-doc which you can find them in maint-guide, please file a bug on debmake-doc with proposed text. If it is something as guideline, you may propose it to developers-reference. (FYI: I am trying to convert developers-reference to sphinx now and working on a branch. Any volunteer to help this is appreciated.) Osamu