Announcing: Slashdot Deals - Explore geek apps, games, gadgets and more. (what is this?)

Thank you!

We are sorry to see you leave - Beta is different and we value the time you took to try it out. Before you decide to go, please take a look at some value-adds for Beta and learn more about it. Thank you for reading Slashdot, and for making the site better!



Writing Documentation: Teach, Don't Tell

lahosken Re:Wikis are better than nothing (211 comments)

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.

about a year ago

Undersea Cable Repair Via 19th Century Tech

lahosken Sophisticated Grapnels (98 comments)

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

about 8 years ago


lahosken hasn't submitted any stories.



lahosken lahosken writes  |  more than 11 years ago I am so sick today. I never left the apartment. I'm just sitting and playing with the computer all day, feverishly typing, making no sense.

Slashdot Login

Need an Account?

Forgot your password?