Beta

Slashdot: News for Nerds

×

Welcome to the Slashdot Beta site -- learn more here. Use the link in the footer or click here to return to the Classic version of Slashdot.

Thank you!

Before you choose to head back to the Classic look of the site, we'd appreciate it if you share your thoughts on the Beta; your feedback is what drives our ongoing development.

Beta is different and we value you taking the time to try it out. Please take a look at the changes we've made in Beta and  learn more about it. Thanks for reading, and for making the site better!

Comments

top

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
top

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

more than 7 years ago

Submissions

lahosken hasn't submitted any stories.

Journals

top

lahosken lahosken writes  |  more than 10 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 Account

Need an Account?

Forgot your password?

Don't worry, we never post anything without your permission.

Submission Text Formatting Tips

We support a small subset of HTML, namely these tags:

  • b
  • i
  • p
  • br
  • a
  • ol
  • ul
  • li
  • dl
  • dt
  • dd
  • em
  • strong
  • tt
  • blockquote
  • div
  • quote
  • ecode

"ecode" can be used for code snippets, for example:

<ecode>    while(1) { do_something(); } </ecode>
Create a Slashdot Account

Loading...