Guide to reading documentation

... or more to the point, how not to write documentation

Well it appears as if I’ve made some slight progress on this satellite issue.

It appears that the satellite terminal currently in use uses a really obscure cable serial standard.

The frustrating thing is, that in the documentation, the only mention of this obscure standard in relation to using it with non-PC equipment is a footnote at the bottom of the page which says something along the lines of “Yeah if you’re using this terminal with something other than the kit provided, then you need to use the RS-530 serial transmission cable standard.”

That’s it. It was ...

Cisco serial debugging woes

not helped by shitty satellite terminals

I’ve had enough. I’m going to petition Cisco to start providing some more debugging information when trying to get Serial interfaces working.

Picture the scene: a lovely super yacht which has installed on it a satellite terminal and dome which connects it to the rest of the world. That terminal has a serial interface on for connection to a modem or computer equipment. Take one Cisco Router with a WIC-2AS interface in it.

Now the satellite terminal and documentation is appauling. As documentation goes, it’s amoung some of the most contrived and vague documents concerning something ...