On Thu, Oct 11, 2018 at 06:10:43PM -0700, Russ Allbery wrote: > Stuart Prescott <stu...@debian.org> writes: > > > In counterpoint, I'll add to that 4169 packages register 5318 sets of > > documents in doc-base. To me, that says that we've got a lot of packages > > who are advertising their documentation this way. > > I wish I had some feel for how many people were actually using doc-base as > a client, though. How many users actually run the tools and use them to > find documentation, and is it successful for them? > > I dutifully provide doc-base registrations for all the documentation in > all of my packages, but I think in all the time I've been using Debian > I've only run the tool as a user maybe twice, and then only to check > whether my package documentation showed up. So the fact that my packages > all have doc-base registrations doesn't indicate those registrations are > useful, necessarily.
I do the same. On the other hand, it is useful for QA because lintian will complain if the documents advertised in doc-base do not exist anymore, so you know if the documentation build process has some issue. [[ But that sad truth is that the real issue is not that users do not use doc-base, but rather that they do not use the documentation provided in Debian in the first place, and instead reach to Google to locate some documentation online (which might not be for the same version, leading to conflict with upstream) ]] Cheers, -- Bill. <ballo...@debian.org> Imagine a large red swirl here.
