FreeBSD is a 'distribution' and Linux is a 'kernel', which in the context you're discussing is an important distinction. Pick a same-level entity to compare - Fedora? Ubuntu? Arch? Not saying that the documentation is as good, just that the question is apples vs oranges.
They have the gnu info pages which comes with emacs. Man pages is a dying artform. With all the github projects out there they may have, if your lucky, a help dialog switch but no proper man page for their projects.
The man pages that come with FreeBSD are absolutely fantastic and top notch, more so than most of the man pages I have found with Ubuntu for example.
I don't see how Linux being seen as a programming platform makes much if a difference. FreeBSD has a pretty large community as well, but the core community that puts together the OS seems to take much more pride in their work and having it be fully documented than any other open source organisation.
Which is the problem with Linux as a whole for me.
WiFi configuration is a particular problem where everything has awful documentation so when you need to set up your WiFi without NetworkManager or some other behemoth, much eye poking and googling on other devices is required.
FreeBSD/OpenBSD/NetBSD: man ifconfig (and dmesg)
As a rule, and this happened to me more than once, you might need to configure your network connection without the aid of Google and online documentation. Either that or you're stuck on a train in the middle of nowhere with no WiFi and no 3G and you want to read the docs.
I disagree; In general, I prefer Info. I would explain why, but that would be repeating myself; I instead refer to my previous post on this very topic:
I develop primarily on FreeBSD (80% C, 20% nodejs) and test for compliance on Centos Linux. My experience is that code written and tested on FreeBSD has so far fewer bugs this way. Package management is more intuitive, too.
Yeah, port system is fantastic. It takes longer, but just works. The whole system is designed to be robust, there's no broken shit if it's done successfully. *It reports error on failure at least.
Linux package managers are fast, but usually broken silently in some ways - which are critical on robustness - and I always discover myself manually doing what port system does.
CentOS packages are relatively more robust, but it's too outdated, and installing new packages nothing different from any other Linux distros.
My experience - and one of the main reasons I switched from BSD to Linux is that the ports sytem is a broken pile of stuff. Yum on CentOS is a joy to work with in comparison.
I see the FreeBSD devs have finally started to see the light with the introduction of Pkgng.
Ports broken? Usually see this complaint when the user has an up to date ports tree, but out of date freebsd install.. Ports doesn't have branches/releases.. So if your fbsd version is no longer supported, you'll start seeing broken ports.
Pkgng is not a replacement for ports.. It's a replacement for the old pkg manager (pkg_*)
The FreeBSD ports system is wonderful because it lets me vary the version of an application without forcing me to replace world. Yum is great when you want a binary distribution that often lags the latest releases by years. What do you do when you need a more recent PostgreSQL than 8.4? Upgrade your OS? snicker Why should I be forced to disrupt my OS when all I want is an application? I develop in the CentOS environment on a daily basis. I long to return to the simplicity and elegance of FreeBSD.
Sure, I'm already using that option. I had to go and find it on my own, at the time. It wasn't as simple as updating the ports collection and installing from ports, but I suppose it's not much different than waiting for a maintainer to update a package and then installing it.
I use ports to mean compile on my own and packages to mean installing precompiled binaries. In my experience, FreeBSD seems more amenable to managing, building, and installing software from source code than a linux distribution. Perhaps I just haven't learned an efficient manner that integrates well with yum/rpm on CentOS? I've always had more dependency nightmares on a linux distro than with FreeBSD. Using FreeBSD's ports collection (single repository) has been less error prone for me than trying to manage all the different yum repos one must manually organize to get up to date software. Am I doing something wrong or is it really that clunky?
Yes, I guess if what you want is to build software from source, then the ports are not THAT bad; but when you want to get a little more generic or care about deployment time (especially when dealing with cloud instances) then the fun goes away. Plus the rolling release nature of the ports sucks arse..
I'm not advocating against FreeBSD, I like FreeBSD and I want to see it again on the table, but the ports are hurting it and its adoption, it needs to go away.
You are quite correct that installing from source doesn't really scale in hosting services. It does take too long and leads to incongruent deployments that may block migration. I don't believe any distribution is well suited for cloud deployment out of the box. I usually deploy from a suite of prepared images via netboot, then customers are free to compile from source or use canned packages.
"The Journal will be a bi-monthly publication and will be available on the web or as an Android/iPhone/Kindle app."
Why make it an app? Making "app" magazines seems really dumb to me, when you could simply make it available in an open format like PDF or ePub or text.
[1] https://www.freebsd.org/doc/handbook/