Don’t use the source, Luke

The webdocs.org documentation repository (via Simon Willison) seems like a vaguely neat thing; a gathering of Python documentation. I have a bit of a flaw with it, though; I wondered how it was done — do they manually update it, are they picking up some kind of XML summaries from the author’s sites, what — so I looked at the source. And it is completely unhelpful in this regard. This is perhaps a more worrying aspect of the web services trend — you’ve got no way of looking at the information you get back, because all the client-side code you get boils down to a couple of RPC requests and some processing code rather than actually containing the data itself. I suppose that that’s just a consequence of the way things are going. ——-

I'm currently available for hire, to help you plan, architect, and build new systems, and for technical writing and articles. You can take a look at some projects I've worked on and some of my writing. If you'd like to talk about your upcoming project, do get in touch.

More in the discussion (powered by webmentions)

  • (no mentions, yet.)