Archive for the 'PHP' Category

Content first, structure later

Wednesday, June 15th, 2005

Paul M. Jones has a great blog post entitled Wikis **Are** For Documentation. He says:

This stand [that wikis are insufficient for documentation –ed.], in my opinion, addresses the wrong problem. My basic rebuttal would be that PHP userland lacks not merely “robust”? documentation, but that it lacks “almost all”? documentation. The key here is not merely to improve the state of existing docs, but to get **any** docs to exist in the first place … and wikis help with this tremendously. They are not perfect, but they are a great start to get some docs out there.

Paul’s writing in response to Sean Coates, who says Wikis are not for documentation and makes a strong argument that low-barrier to entry collaborative writing that enables quick iterations is a great for documentation writing, even at the expense of structure.

Of course, just because you don’t require structure doesn’t mean you can’t allow structure. Technical documentation benefits from structure, but suffers from required structure. Make it easy for people to write something (anything!) and worry later about getting it into a structured format.

On a related note, I had a good conversation last night with Alex Russell, a developer on JotSpot (whose apt. we fled to from the tag tuesday tsunami scare – I’m told it wasn’t his apartment. I assumed it was, since he new the WEP key. :-)). One of the interesting things they’re doing is creating wiki software that can be shaped into a more structured application. This bottom-up/content-first-structure-later approach could be very fruitful for technical documentation. He and I both agree that it is difficult to figure out exactly what the structure of your data should be until the data is large enough to cause you pain. Unfortunately, few tools are capable with dealing with this workflow style.

The tools must improve.

wordpress + kubrick + hReview = trouble

Friday, June 10th, 2005

If you try using with Kubrick, the default template for WordPress, you will notice a bit of a problem. You see, hReview has a class called “description”? and so does Kubrick. Unfortunately the default stylesheet for Kubrick styles the description class as white, giving use white on white text- not the easiest to read.

If you’d like to do an hReview with Kubrick, here’s a drop-in stylesheet replacement.

For the the DIY crowd out there, all you need to do is change the .description selector to only select div#headerimg div.description and then move all style rules for .description into that block.

For those of you who have no idea what I’m talking about, just come back later.

PEAR 1.4 takes a REST

Sunday, April 24th, 2005

Greg Beaver has decided to try moving from XML-RPC to REST for the pear installer:

I suspect the only reason nobody thought to do this for the first incarnation of the PEAR installer is that REST just isn’t as sexy in appearance. I mean, how cool is it that you can call a function on a remote server as if it were in the same script? REST requires clunkier thinking in terms of resources. It is more like accessing information in an xml file via XPath versus grabbing it through an abstraction that does some of the magic processing for you.


Become a MacroPatron

Saturday, April 2nd, 2005

Jason Koettke has a system of MicroPatrons who contribute to his blog. I have a better opportunity for you- Hire me!

My plan A for this summer’s work has not materialized. (I’d applied for YCombinator‘s Summer Founder’s Program). So, I’m looking for work for this summer.

You can view my resume here, but I’ll give some highlights- I’m mostly a webdeveloper and I’m really intersted in New Media kind of projects. Most of my experience is with the LAMP stack (PHP, especially), but I always willingly to learn new technologies.

I’d like to work for someone in the Bay Area, but I’m open to other opportunities. However, for opportunities in the Bay area, I would possibly be able to continue working even after I go back to school in the fall (at USF).

If you have, or know of any opportunities, email me.

Python never had a chance against PHP

Wednesday, March 30th, 2005

From Python never had a chance against PHP:

Also people continue to confuse simplicity with deficiency.

Well said and a good article about why web development with PHP is comfortable for many people.