libregnition
I’ve not been tracking all the problematic cases I encounter but OpenVPN is a good example of something that has a decent level of documentation content but the quality is poor because of broken links in the man page and links that direct people into an access restricted walled garden. (https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1065879).
(update) after some quick checks…
- Imagemagick: these docs are quite useless in my browser:
/usr/share/doc/imagemagick-6-common/htmlapparently because the links are external (thus rely on being online) and they are broken also for me despite being online. - Pipx: these docs have many external links: /usr/share/doc/pipx/html-docs/index.html They are not going to access restricted walled gardens AFAICT, but some to Github. It’s really not great that you must be online. Anything in
/usr/share/doc/should be complete and local IMO, so offline people are not excluded. - fallocate → dead links http://thread.gmane.org/*
- /usr/share/man/man2/getrlimit.2.gz (and others) → http://marc.theaimsgroup.com/?l=linux-kernel&m=114008066530167&w=2 (dead to me)
- /usr/share/man/man2/init_module.2.gz → http://www.tldp.org/HOWTO/Module-HOWTO/basekerncompat.html (dead to me)
- /usr/share/man/man2/adjtimex.2.gz → http://www.bipm.org/en/bipm/tai/tai.html (dead to me)
- /usr/share/man/man1/pgmminkowski.1.gz → http://rugth30.phys.rug.nl/pdf/prechaos.pdf (dead to me)
- /usr/share/man/man1/patchwork.1.gz → http://www.graphviz.org/* (dead to me)
- /usr/share/man/man1/xorriso.1.gz → http://atterer.net/jigdo/ (dead to me)
- /usr/share/man/man1/markdown.1.gz → http://michelf.com (dead to me)
- FFMPEG et al man pages are littered with copious external links many of which are access restricted. E.g. http://www.dolby.com/* (Cloudflare restrictions)
- /usr/share/man/man1/perl5260delta.1.gz → http://stackoverflow.com/questions/30412951 (Stack[exchange/overflow] recently joined Cloudflare’s walled garden; but there is a S/E frontend so links can be made reachable to everyone)
- /usr/share/man/man1/chromium.1.gz → http://library.gnome.org/devel/gtk/stable/gtk-running.html (404 error)
- /usr/share/man/man1/texdoctk.1.gz → http://www.cs.wisc.edu/~ghost (humanity check… the CAPTCHA itself fails to render for me)
- pretty much all Tcl/Tk docs are a Cloudflare exclusivity shitshow. And man pages reference into that exclusive walled garden.
- /usr/share/man/man7/soxformat.7.gz → http://www.arl.wustl.edu/~jaf/lpc/ (dead to me)
I didn’t do an exhaustive check… just ran find /usr/share/man/ -type f -exec zgrep --color -nHi -e 'http:' \{\} + which got 10s of thousands of hits, and checked some of them arbitrarily.
All third party software.
Irrelevant. These are all official Debian software pkgs and thus subject to Debian’s quality standards (derived from the Debian Social Contract, DFSG, and Debian Policy Manual). None of that software originates from outside the official Debian repos, thus none of it is “non-Debian”.
Where are your patches?
Who’s to say there’s anything to patch here? Until the Debian Social Contract, DFSG, and Debian Policy Manual evolves as proposed so that exclusive-access docs are considered a defect, these are not bugs.
You seem like a concerned troll.
You’re the asshole who entered this thread to troll instead of contribute. If you’re not going to be part of the solution, please fuck off.
Third-party is NOT Debian, ever, even if you try to twist definitions. It’s also open-source, we have jobs too to feed our families.
Nonsense. You obviously are unfamiliar with how Debian is structured and documented. You lack a basic grasp of the culture and language. You’ve apparently never read the release notes. “Debian” and “non-Debian” has a clear line, and “third-party” is wholly irrelevant. A vast majority of Debian packages are sourced from an upstream 3rd party. All Debian packages have a Debian maintainer and are subject to Debian policy. Non-Debian pkgs lack a Debian maintainer and by definition are excluded from official Debian repos. You’re obviously incompetent for any discussion about the DFSG, DSC, and Debian Policy Manual without this basic understanding and have no hope of contributing to a discussion you don’t understand.
I do, and it’s the job of everyone
It’s not a question of who does the work, which is irrelevant to the discussion of whether there’s work to do and how that work is defined.
we all agree that it goes in the bugs category.
Nonsense. You’re not following along. The whole point is that there is no agreement that these are bugs. You’ve failed to grasp the thesis of the OP.
Feel free to clone repos and fix those bugs.
Feel free to waste your own time doing work that is not agreed on. I will spend my time getting agreement per the proposed changes in the OP.
BTW, your comments also show contempt for FOSS principles and specifically Debian principles of not demanding work of others. It’s a volunteer effort and everyone is free to allocate their own time where they see fit. Since you obviously don’t give a shit about high level docs, social contracts, and quality standards, it’s better if you just fuck off rather than task people with unagreed work.