Interview Transcript: Matt Welsh

This is Dale Dougherty and I'm here with Matt Welsh, one of the founders of the Linux Documentation Project, also an O'Reilly author of Running Linux. Matt, tell me, in Linux years you're about eight years old. What were you doing in year one there?

Matt Welsh:
I started with Linux back in about 1992 when, much to the amusement of my friends, I went out and bought a new hard drive and tried to install what was really the only Linux distribution that you could call serious at the time, something called MCC Interim. It came on three or four floppy disks.

Dale Dougherty:
Where did you get that from?

Welsh:
I actually downloaded that from the Internet, but it was kind of problematic to make the floppies on a Sun workstation and get them to work under Linux. It was pretty low level and hard to install -- very difficult to even know what you had to do to get it installed. That was the early days before X Windows and before networking.

Dougherty:
You were a student?

Welsh:
Yes, I just started my undergrad degree at Cornell and when I bought this new hard drive I was plugging it into the box that went into my dorm room there at Cornell University. It was a 200 megabyte hard drive that cost me $550, so that kind of tells you in computer years how long ago that was, right?

Dougherty:
So, how did the Linux Documentation Project evolve?

Welsh:
This was basically the result of myself and Lars Wirzenius and Michael K. Johnson -- I guess Michael's now at Redhat and I don't know exactly what Lars is doing these days -- getting together and saying we wanted to produce printed documentation for Linux, so we wanted to write manuals. Michael was going to work on a kernel hackers guide and Lars was going to do a systems administration guide and I was going to do the installation guide. We got together and hashed out our ideas and started writing some documentation and putting this stuff up online. It was just written in LaTeX so the only way you could view it was to actually print it out or to use Ghostview or something like that. It wasn't extremely practical, but this did pre-date the Web. After maybe about a year or so, this evolved into a larger project where we were actually taking a lot of the documentation that people were writing anyway -- Read Me's and FAQ's and things like that -- and helping to organize and distribute that. Again, this was all before the Web, so mailing lists and Usenet newsgroups and things like that were the main ways that we got the information out there.

Dougherty:
Did Linus produce any documentation himself?

Welsh:
He had a pretty weak Readme file that went along with the kernel source tree, but that was really about it.

Dougherty:
So, in terms of raw materials, you didn't have much to work with?

Welsh:
No, no. I mean when I started writing documentation, there was some pretty inconsistent documentation out there already, some Read Me's and FAQ's. One of the most famous early documents was somebody produced a whole directory listing of every file on a working Linux system. He said, "Well, I finally got Linux to work, so here's the listing of where every file is on the system," and it printed out to 40 pages of listings of just where the files were. So, that was kind of interesting, but it's not extremely helpful to somebody. We got together and said, "Well, we're going to write some new documentation and talk about how to actually get a system working from scratch."

Dougherty:
So, what time period was that?

Welsh:
This must have been summer of '92 to summer of '93. That academic year for me was when all this really started happening.

Dougherty:
And, eventually you built a tool setup for producing the documentation?

Welsh:
Right. So much later -- well not much, you know, in Linux years it was a year or so later, but it seemed like a long time. It was becoming frustrating to develop Linux documentation in LaTeX and HTML was just kind of coming out. Nobody wanted to write in HTML. There was a bunch of people who wanted to write groff or something like that. It was becoming problematic. I found a suite of tools that let you write documents in a simplified SGML format and convert that to groff. It gave you plain ASCII and HTML as well as LaTeX. The set of tools was already out there and I just took those packages and repackaged them and documented them and added some features and nice front-ends so that it was very easy to write your document in this format and then just run one script. It would give you plain ASCII and HTML and Postscript, -- now people who wanted to print it out could get postscript and people who wanted to view it on the Web could use HTML. But, by far the most important format back then was plain ASCII. I ended up calling these tools LinuxDocSGML because it was SGML and it was for the Linux Documentation Project. And, I guess about a year later some people took that project and renamed it and repackaged it again and called it SGML Tools and that's still a working project.

Dougherty:
Right. Although on the site, it says it's not current.

Welsh:
Is that right?

Dougherty:
Yeah.

Welsh:
So, maybe it's fallen by the wayside a little bit.

Dougherty:
So, LinuxDoc.Org, when did that get launched?

Welsh:
I don't remember exactly when that domain name started getting used. I think it was after I had stopped working on it. The original Linux Documentation Web site was written by myself and I think it was one of the first Linux Web sites; it may have been the first Linux Web site and that was hanging off of sunsite.unc.edu which is now called MetaLab.

I just said "Hey, let's put all this HTML documentation we have as well as links to everything Linux related on this one big Web page." It was just one giant Web page with links to everything on it. That was the first Linux Web site and it was very popular. The number of hits that we were getting was pretty significant. There are still many, many, many links out there on the Web pointing to that original page. After I stopped working on these things so much, the LinuxDoc.Org domain name was pointed to that Web site and over the course of the years the maintainership of that has changed hands a couple of times.

Welsh:
No, after a few years at Cornell I just became too busy. I got involved doing research work there and also the book project with O'Reilly, that kind of took a lot of my effort. It seemed that a number of people, such as Greg Hankins, who was at Georgia Tech at the time, had taken on a lot of the roles that I was originally playing in that field and were doing an amazing job at it; people were filling the gap that I'd left behind.

Dougherty:
So, is it on its third generation?

Welsh:
Maybe third or fourth, I don't know. It has a life of its own and I have to say I don't know most of the people involved right now, but the Linux Documentation Web site has a whole new look. The content is fundamentally the same as what we originally had.