Travis Swicegood has a post questioning the value of the docblock. I have a deep sympathy with this sentiment.
Even on projects with extensive generated documentation, I find that kind of documentation to be of extremely low value. The problem with inline API documentation is that there is no sense of priority. Developers [...]
On the Perils of Inline API Documentation
April 13th, 2007PDO Design Evolution
October 23rd, 2004Alan Knowles has an interesting post on PDO.
I really don’t know much about PDO, i haven’t used it yet. Most of what I know comes from:
Wez Furlong’s first steps with PDO examples
Wez’s Oracle PDO Article
John Lim’s discussion of adodb and PDO
A sitepoint thread on PDO
I haven’t seen any API type docs yet. I [...]
Evolution not Revolution
June 18th, 2004I ran across an Interview with Scott Collins about Mozilla at ArsTechnica. In light of Joel Spolsky’s How Microsoft Lost the API War article, I found one comment particularly interesting:
And we didn’t get out a 5.0, and that cost of us everything, it was the biggest mistake ever
This was obviously an emotional issue for Scott, [...]
API Design
May 5th, 2004I ran across a couple older items on API design: Words of Wisdom on Designing Usable APIs and Think of Objects as Machines.
good API designs happens when designers think of … client programmers as users.
I wish more developers took this to heart. I’ll add my own law of API design:
Good API design makes common [...]
Feed
Subscribe to this blog…