Please create an account to participate in the Slashdot moderation system

 



Forgot your password?
typodupeerror
×
Linux Software

Help the Linux OpenBook Project 54

Phexro writes "Looks like Nick Petreley, IDG and the LinuxWorld gang have a neat idea- Open Books. They are soliciting the Linux community to help write "The Essential Linux", which will be written and edited completely(?) by the members of the Linux community. The finished work will be distributed under the terms of the IDG Books Open Content License." I'll probably volunteer; I'm already in the Open Source Writers Group. But will enough others participate to make it a viable project? (More below)

The reason I wonder if this project (which I think is an excellent idea) will draw enough support is that it's facing stiff competition from commercial publishers. The market for Linux books is so hot right now that one New York literary agent I know, Lisa Swayne, is literally begging for Linux authors.

While much Linux software is free, books about it cost plenty. An awful lot of people, including me, have noticed this and are not happy about it. Writing is not that much different from coding. In many ways. the two tasks are different applications of the same talents, and the way writers and coders work is quite similar, especially the fact that people who are good (or want to get good) at either task often become so obsessed with their work that they give up almost everything else in their lives. Given this similarity, why should people who write about free software almost invariably get paid, while people who write free software are expected to "contribute to the community" without getting any money in return?

Personally, I believe it is the duty of any writer or editor who uses free software to donate his or her skills to the community, just as programmers who use free software often contribute bugfixes and patches even if they aren't heavily involved in kernel or applications development. We each can and should contribute in our own way.

But now Linux is going big-time, and publishers move in packs just as surely as Wall Street investors, so suddenly there's competition for anyone who can write competently about Linux. I believe this is going to lead to a lot of bad books, just as the explosion of science fiction's popularity in the 1970s led to the publication of many SF novels that never should have been printed.

I believe Open Source books have the potential to be better and more useful manuals than those written under commercial pressure. Editing is the writer's equivalent of debugging. Just as good programmers often spend more time debugging than actually writing code, good writers often spend more time editing their work than typing their first drafts.

If you are a programmer who can write, or a writer who understands programming, I urge you to donate at least a little of your precious time to either of the two Open Source writing projects mentioned above, or to one of the many other worthwhile ones that have sprung up elsewhere.

Sure, there's lots of pressure to spend every waking moment making money coding or writing, but doing the same work without deadline pressure, for love instead of money, at least a few hours every week, will not only make you feel better about yourself, but may also help you improve your skills in ways you cannot when you're cranking out copy or code against a commercial deadline.

Note: this story was posted briefly earlier, then pulled when we discovered that LinuxWorld's servers weren't responding. Now, at 1:13 EDT, LinuxWorld is back up, so the links all work. - ed

This discussion has been archived. No new comments can be posted.

Help the Linux OpenBook Project

Comments Filter:
  • I'm not sure how well it will actually work, though. First off, I disagree with the assertion that programmers make good writers, because I've read spec's and howto's written by the programmers I work with, and believe me they don't have the knack.

    Second, I don't know that the open source model will translate to books. If every section is written by a different person, someone is going to have to spend a heck of a long time editting and rewriting, to even get to a semblance of a unified style.

    And last but certainly not least, does it matter that people are getting paid? Even if the author doesn't get paid, the book is not going to be free. I don't know what the ratio is in tech books but in fiction the author gets about 3% of the selling price. I for one don't see that as a huge savings, and will continue to buy and recommend O'Reilley books, whether it's in the spirit of the community or not.

    Using Microsoft software is like having unprotected sex.

  • It seems like a decent idea. its always better to get more people working on one thing, cause the vast amount of knowledge being shared equates to something that is of high quality, and something you can trust for referrence... i'm all for this.

    ----------
    Have FreeBSD questions?
  • by Aleatoric ( 10021 ) on Tuesday August 24, 1999 @08:39AM (#1728300)
    While I think this could be a good idea, I question the assertion that the people involved with Linux (coders, writers, et.al) should not get paid (if they can) for their work.

    It's true that many of us write code for the fun of it, and I suspect that there are many writers (even technical ones) that also write because they enjoy it, and would do it whether they get paid or not.

    However, as many before me have argued, we don't have to separate Open Source from economic gain. Many of our favorite Linux coders are getting paid for Linux coding, do we grudge them that merely because the rest of us are doing it for free (or nearly so)? It is frequently argued that support is the most meaningful economic model for Open Source projects, in that you can get the software gratis, and you get the support at some cost (either you take the time to learn to do it yourself, or you lob a little cash to someone who is able to teach you).

    I think the idea of an 'Open Book' is pretty cool, and almost certainly do-able. And it would be interesting to see how it would turn out, especially if there were many contributors. But if an author can make money writing a Linux book, I would say go for that if you can, just as if they could make the money writing Linux code.
  • Dumb question?

    Maybe, but I think one of the reason there are lots of programmers writing Linux and Open Source software is that they hope for a little fame and peer recognition.

    Just about any /.'er can name 5 famous programmers, but can they name famous tech writers (without looking at your bookshelf)? Let's see, Peter Norton, and, umm, Xian Crumlish.

    Writing documentation never seems to get the respect that programming does. So why would someone want to write for free if they can't even get a fraction of the respect that Torvalds, Tridgell or Becker gets? Can you see some hot startup wooing a tech writer because of their clear, expository pose? Can you see a startup letting an Open Source tech writer get in on their IPO? Do you ever hear of tech writers cashing in and retiring at 30?

    George
  • by DeadSea ( 69598 ) on Tuesday August 24, 1999 @08:48AM (#1728304) Homepage Journal
    While better literature on linux is needed, why books? Large, clunky, expensive, environmentally unfriendly, wouldn't it be better to write some good online materials about linux? As linux seems to be changing so fast, wouldn't online materials, be easier to keep up to date as well?

    The HOWTOs are a good first step but aimed at the user that is a bit more familiar with linux already than someone who might buy a book about unix. I'd suggest something along the lines of what Sun has done with Java. They have the Java API index of everything which is much like the linux HOWTOs: Lots of info, but you have to have some idea what you are looking for/at before it makes any sense. Then they have the Java Tutorial that starts with the basics and dumbs stuff down enough that anybody capable of programming in Java should be able to start there. Its worked for me in Java. I don't feel that I need more references.

    How about a linux tutorial that tells the user what they can do, and links to HOWTOs and new material to help somebody accomplish what they want?
  • I would love to help out with this or any similar project, but I'm not sure how. I have good writing skills, and have been using Linux as a hobby for a couple of years, but I lack programming knowledge or any in-depth configuration skills. However, I would certainly be able to take the ruminations of a more technical person and parlay those into a form readable by regular folks. And, after everything I've downloaded over the years, I'd be happy to work for free. Is this a viable skill? Any suggestions?
  • My first question is, why not simply channel all that effort into the LDP?

    In the linuxworld openbook newsgroup the answer is answered thusly:

    In some ways, you are right, this is YALDE (Yet Another Linux Documentation Effort). But there are important differnces between this book and the LDP. A few of them are:

    1. Focus. This will be a book, not an encylopedia of everything Linux.

    2. Product. This will be a professionally crafted, edited, bound, and published work which will extend the information to virtually every corner of the globe by virtue of IDG's worldwide presence and translation partners.

    3. The information in this book will be a natural for the LDP to include in their project rather than the other way around. We should have 'fresher' data.

    I hope this answers at least some of your concerns.

    See ya,
    Joe Barr

    I'm concerned there may be a lot of duplicated effort here. And from some of the other discussion in that newsgroup I think the issue of focus will be a tough one to resolve. I have a hard time picturing one book that will be "essential" both to Linux newbies and experienced sysadmins.

  • This might seem a inflammatory, beware.

    One reason that new coders write Open Source code may be that they're trying to make a name for themselves, and are having trouble getting paid for coding. Can you imagine sending a 3 page codelet to Microsoft (or Sun, or RedHat) and hoping to get hired on that alone? I think you need a hell of a lot of qualifications to get paid for coding without any relevant paid experience.

    Contrast that with writing. My team got a book contract on the basis of a 3 page Table of Contents, with little paid writing experience. It's cheap for a publishing company to throw a few thousand dollars at unknowns in hopes that 1 out of 10 books will be a good one.

    George
  • I don't know that the open source model will translate to books.

    I'm not sure that the bazaar model would translate at all well to a Linux 'installation and getting started' book. To take one example, how much swap space is needed? Everyone has their own opinions on this; any 'collaborative' book could not be decisive. It might be like 'design by comittee'.

    The point is, most books need an author with an opinion. Even though expert users may not always agree with the author's opinion, it's needed to pull things together and keep the book focussed.

    One way this could be made to work is similar to how many successful free software projects work - make it modular. If the book is split into twenty chapters, with at most two people working on each chapter, then you wouldn't have people stepping on each others' toes. You'd also need a single editor who has the final say on what goes in and what goes out, with maybe a couple of sub-editors who check and revise things before sending them upwards.

  • From my limited experience, royalties for computer books start at about 10%, more if you have a track record or an aggressive agent.

    George
  • Please gimme a break!

    "Do me this for free, I'll take credit to my superiors/stockholders, and all the related profits..."

    Yeah, RIGHT!!

    Same editors of all those Linux "bibles" and "for idiots" sh1t.

  • I disagree with the assertion that programmers make good writers

    I didn't read Roblimo's comment that way. He wrote: "the way writers and coders work is quite similar, especially the fact that people who are good (or want to get good) at either task often become so obsessed with their work that they give up almost everything else in their lives."

    I agree that a lot of the HOWTOs, man pages etc out there now are pretty close to incomprehensible to non-programmers like me. But I think it's true that programmers and writers have similar work ethics. (I've done writing/editing for quite a few years myself.)

    I also agree that it's unlikely the end result of this product will be a "cheap" book. Presumably the full contents will also be posted for free on the Web (would be interesting if IDG sells banner ads to those pages, though) but as I said in another comment, don't we already have the LDP?

  • Any type of online docs are great. IF you can get to them. Sounds silly, but when I installed Linux I didn't know much. I read the install directions that came with RH5.2. Followed them. Couldn't get my modem working though. Took me a while of searching through the book to find the stuff about HOWTOs. Then to get to them on my computer. To find out that I was probably having a problem with PnP settings. Blah blah blah. Point is:
    1) You can't read electronic docs to install something. Install docs need to be in paper form.
    2) Web docs alone may be useless. My modem didn't work. So no internet connection. So I missed a lot of the documentation out there.
    3) Some people like reading paper more than computers.
    -cpd
  • In the sense YOU see Linux (as I think),
    it is W. Richard Stevens. But since he is
    a UNIX (not linux) writer, and he is very
    kernel+performance read-all-geek
    he does FUNDAMENTED critics to Linux.

    But his books are really admired and
    read by the hacking community.

  • I don't like it one bit!

    Paper? Printed? Pashaw!

    LDP. Get the LDP on a nicely integrated, professional looking website.

    Thats where its at.

    Will IDG "donate" their printing presses (contracted out facilities)? I don't think so.
  • donkey punch, inc.

    you're a sick bastard. i love it.

  • by AJWM ( 19027 ) on Tuesday August 24, 1999 @09:44AM (#1728322) Homepage
    The book outline starts out with "What kind of server do you want" and goes from there. A book for "Essential Server Linux" is a fine idea, but I'd hate to see someone looking for something about Linux on the desktop (or embedded, or wearable, or whatever) pick this up.

    Nothing against documentation, mind, but anyone calling a book "Essential Linux" and planning on it being only about servers is misguided.

    How about a series? "Essential Server Linux", "Essential Desktop Linux", "Essential Wearable Linux", "Essential Toaster Linux", etc...
  • by Xamot ( 924 )

    I agree. Was the LDP ever an Encylopedia of Linux? As I recall it had regular books. I for one would like to see the LDP revived. It seems pretty dead to me. I am trying to network a couple PC's and looked at the Network book, it hasn't been updated in a LONG time.

    While I have nothing against this project, I would encourage people to contribute to the LDP(or GNOME's docs) if they want to do some writting for comunity.


    --

  • The definition of "book" can be broader - I would expect the OpenBook to be available online, with publishers allowed to publish the book physically - kinda like: the linux kernel + all pkgs are available online, but you can buy distribution CDs if you like.
  • How do you interpret, "While not mandatory, you should offer a free copy of the modifications, whether in print or on CD-ROM, to the original author(s) and to IDGB."?

    Does this mean that they don't have to make the text of the book available for download? The part of copyleft that really makes it work is that you have to give out source code on request. It sounds like they're trying an "almost-free" way to get people to write books for them. They profit and the writers get nada. Great deal!

    I, for one, would not participate in this...
  • I am doing something similar or have been for a few months now at my website--NHF's Newbieized Help Files. Mostly targeted at newbies, but not neccessarily newbies to linux in general. For example, someone may have used linux for years, but never set up their own network in their home and they wanted to use ipchains. Then they would be a newbie to ipchains? Thats where NHF's come into play.

    is IDG's Open Book Project simliar to mine?

    Sensei
  • That's a great idea! A Windows to Linux installer, have it call FIPS and a customized version of FDISK. Then, have if format the ext2 filesystems, modify the MBR, and copy a base system to the new filesystems.
  • what can i say, i try ;-)

    ----------
    Have FreeBSD questions?
  • As someone who did some technical writing early in his career, I can state unequivically that not only do writers rarely get the same respect, they rarely get anywhere near the same pay.
  • You could volunteer with the Open Source Writers Group (http://www.thepuffingroup.com/oswg/ [thepuffingroup.com]). The OSWG is an project that works to match volunteer writers and editors with open-source projects that need help with their documentation.

    Open Source Writers Group [thepuffingroup.com]
  • I don't think an effort to create Open Source books, in the GPL sense of open source, about linux will ever work. Simply, the desire to scratch an itch doesn't exist as it does in programming.

    Take my example, I'm currently trying to find out information about using colors with GDK. There apparently is a black hole of information about the subject out there. There are many GTK+/GDK applications that use color, which implies there are many programmers that understand how it works. However, there is virtually no information on the subject in documentation any where.

    So I thought to myself maybe after I figure it out I'll write something up. But, why should I? I'll do the work to figure it out (scratch my itch) in order to write a program I want/need. Afterwards I get to use that program (scratch my itch). However if I write up some documenation on the subject, I know it, very well quite likely. What benefit do I gain from the documentation afterwards? What itch does it scratch? I already know everything in the book, I'll never use it.

    As far as I can see, the Open Source software movement hasn't been rewardless for those who participate in the coding of it. They get to use what they produce. Documentation on the other hand is a different beast. A good manager at a software firm will note that good documentation will save many headaches when you return to modify the code later. But even with that, you'll find his employees still don't want to do it.

    Shot in the dark for a possible solution. Web based documentation. It should be geared to take advantage of the medium as we're trying to be progressive. And the people who maintain sections of the documentation receive percentages of the advertising revenue based on the amount, difficulty, and demand for their contribution, if the site ever breaks even. Sounds like something for Linux.com to try hosting. Hey, VA Linux you listening? :)

    The only other option I can think of is using a QT style license for the documentation. Free is free is free is free, but if you sell it in any way you have to pay the author.

    Ryan Warner
    ryan_warner@fnmail.com
  • Hey, programmers are people too. Some of us have a way with words, and some no have way.

    I doubt that we will get many sections of chapters, let alone whole chapters, written by a single individual. It will be the voice of many people, some contributing just a sentence or a paragraph or a comment or a criticism or a correction.

    Nick and I will do the preliminary editing, and we've had offers of assistance with that part of it too, but for style and uniformity and the like all will be shipped to IDG Book and gone over by their professional copy editors before it gets posted on the web site.

    Everyone who contributes will get something. It may only be an autographed copy of the book, or it might be a check for $500, but everyone will get something back in addition to the opportunity to do something for the community.

    See ya,
    Joe Barr
    aka WaRtHaWg
  • Well, he may or may not be an asset, but he is going to contribute. Why? Because it seems like a cool way to get good, current, Linux docs to a whole lot of people. Also because it is a good way to get people who can't contribute code to contribute in another way.

    In my interview with Stallman a week or so ago at the Expo, he said that if a programmer came to him and volunteered his time to write free software, if Richard found out that he could also write documentation, he would beg him for documentation.

    There is definitely a need. This idea could help meet that need. Of course, if it is restricted to people like yourself who have never made a mistake, it might take a little longer.

    I'm glad it gives the posers something to sneer at, but probably everyone would be better off if they got off their butts and did something for someone else now and then.

    See ya,
    Joe Barr
    aka WaRtHaWg


  • FSF and others are begging for documentation. If you can write, you can help.

    See ya,
    Joe Barr
    aka WaRtHaWg
  • What will be when the first edition will be considered finished? Will you make a 1.1 fork for the development of 2.O edition? Will the progress on the book accessible in a "real time"? Are you going to have all possible formates online when the book will be ready? (sgml, html, tex, ps etc...) Dimus
  • I can just imagine LinuxWorld's reaction.

    "400% load increase? What the hell... OH MY GOD, IT'S SLASHDOT. Everyone turn all the servers off, maybe they'll think nobobdy's home."

    "We can't do that, Simon."

    "Hell we can't. Now get off the floor, call VA and get me more systems. This isn't gonna be fun."

    (:
  • I think it will be a joint decision by Nicholas, myself, and IDG Books when we have enough good content to go to print. We would all like that to occur as soon as possible, but of course have no way of knowing when we will reach that point. I'
    ve been told that 90 days afterwards, the book will be available in printed form.

    It will be available on the web in HTML format all during the development cycle. Nicholas and I will do rough edits, selection, rejection, folding, merging etc on the front lines. Then the text will be sent to IDG Books for their editing. Then we will work with the author(s) to resolve any issues raised by IDG Books. Then the text (be it a section or chapter or paragraph or modification of same) will be put up on the web site. Feedback received from folks reading the text will be incorporated in the same fashion.

    I'm not sure what additional formats we will have online beyond HTML, but suggestions are welcome.

    See ya,
    Joe Barr
    aka WaRtHaWg
  • I can't resist. I'm racking my brain thinking of reasons why writing as a collaborative effort will or won't work. I'm thinking about the boundry conditions. What is the best possible outcome and what is the worst? This came to mind ;)

    Tandem story

    Remember the book "Men are from Mars, Women are from Venus"? Well, here's a prime example offered by an English professor at Southern Methodist University:

    English 44A SMU, Creative Writing Prof. Miller

    In-class Assignment for Wednesday:

    "Today we will experiment with a new form called the tandem story. The process is simple. Each person will pair off with the person sitting to his or her immediate right. One of you will then write the first paragraph of a short story. The partner will read the first paragraph and then add another paragraph to the story. The first person will then add a third paragraph, and so on back and forth. Remember to re-read what has been written each time in order to keep the story coherent. The story is over when both agree a conclusion has been reached."

    "The following was actually turned in by two of my English students: Rebecca - last name deleted, and Gary - last name deleted."

    STORY:

    Rebecca: At first, Laurie couldn't decide which kind of tea she wanted. The chamomile, which used to be her favorite for lazy evenings at home, now reminded her too much of Carl, who once said, in happier times, that he liked chamomile. But she felt she must now, at all costs, keep her mind off Carl. His possessiveness was suffocating, and if she thought about him too much her asthma started acting up again. So chamomile was out of the question.

    Gary: Meanwhile, Advance Sergeant Carl Harris, leader of the attack squadron now in orbit over Skylon 4, had more important things to think about than the neuroses of an air-headed asthmatic bimbo named Laurie with whom he had spent one sweaty night over a year ago.

    "A.S. Harris to Geostation 17," he said into his transgalactic communicator. "Polar orbit established. No sign of resistance so far..." But before he could sign off a bluish particle beam flashed out of nowhere and blasted a hole through his ship's cargo bay. The jolt from the direct hit sent him flying out of his seat and across the cockpit.

    Rebecca: He bumped his head and died almost immediately, but not before he felt one last pang of regret for psychically brutalizing the one woman who had ever had feelings for him. Soon afterwards, Earth stopped its pointless hostilities towards the peaceful farmers of Skylon 4 "Congress Passes Law Permanently Abolishing War and Space Travel," Laurie read in her newspaper one morning.

    The news simultaneously excited her and bored her. She stared out the window, dreaming of her youth -- when the days had passed unhurriedly and carefree, with no newspapers to read, no television to distract her from her sense of innocent wonder at all the beautiful things around her.

    "Why must one lose one's innocence to become a woman?" she pondered wistfully.

    Gary: Little did she know, but she had less than 10 seconds to live. Thousands of miles above the city, the Anu'udrian mothership launched the first of its lithium fusion missiles. The dim-witted wimpy peaceniks who pushed the Unilateral Aerospace Disarmament Treaty through Congress had left Earth a defenseless target for the hostile alien empires who were determined to destroy the human race.

    Within two hours after the passage of the treaty the Anu'udrian ships were on course for Earth, carrying enough firepower to pulverize the entire planet. With no one to stop them, they swiftly initiated their diabolical plan. The lithium fusion missile entered the atmosphere unimpeded. The President, in his top-secret mobile submarine headquarters on the ocean floor off the coast of Guam, felt the inconceivably massive explosion which vaporized Laurie and 85 million other Americans.

    The President slammed his fist on the conference table. "We can't allow this! I'm going to veto that treaty! Let's blow'em out of the sky!"

    Rebecca: This is absurd. I refuse to continue this mockery of literature. My writing partner is a violent, chauvinistic, semi-literate adolescent.

    Gary: Yeah? Well, you're a self-centered tedious neurotic whose attempts at writing are the literary equivalent of Valium.

    Rebecca: Asshole.

    Gary: Bitch.

  • Thanks to both of you for your replies. I'll pursue those avenues and contribute as best I can.

    Fortissimo

THEGODDESSOFTHENETHASTWISTINGFINGERSANDHERVOICEISLIKEAJAVELININTHENIGHTDUDE

Working...