Follow Slashdot stories on Twitter

 



Forgot your password?
typodupeerror

Slashdot videos: Now with more Slashdot!

  • View

  • Discuss

  • Share

We've improved Slashdot's video section; now you can view our video interviews, product close-ups and site visits with all the usual Slashdot options to comment, share, etc. No more walled garden! It's a work in progress -- we hope you'll check it out (Learn more about the recent updates).

×

Comment: Re:Wikis are better than nothing (Score 1) 211

by lahosken (#44752301) Attached to: Writing Documentation: Teach, Don't Tell

Yeah. I'm a professional tech writer, proud of my skills. But in plenty of cases, source-code-with-docstrings is enough.

I hope someone wouldn't hide away these rough forms of documentation, waiting on some exquisitely-crafted docs that they might never get around to writing. I like what he's saying about organization, keeping in mind how someone's going to learn this stuff. But I think he's setting a high bar.

Comment: Sophisticated Grapnels (Score 2) 98

by lahosken (#17598816) Attached to: Undersea Cable Repair Via 19th Century Tech
I read a book from 1896, Wilkinson's Submarine Cable Laying and Repairing. I was pretty impressed with the complicated grapnels they had back then--capable of scooping up a delicate cable, slicing the cable as appropriate. I was so impressed that I typed up the grapnel chapter, scanning in the illustrations: http://lahosken.san-francisco.ca.us/frivolity/wilk inson/I_3.html

"It ain't so much the things we don't know that get us in trouble. It's the things we know that ain't so." -- Artemus Ward aka Charles Farrar Brown

Working...