Skip to content

Entries published on February 11, 2008

1 entry published on this date. See also: all entries published in February 2008, full archive.

On “conceptual integrity”

Mark Ramm has a nice post this morning talking about Adam Gomaa’s discussion of “conceptual integrity” in Python web frameworks; I think it’s worth a read.

The key point Mark touches on is good documentation: ensuring that people see and understand the overarching structure of the framework is, ultimately, the key to helping people understand how it can help them get their work done. In the case of Django there is an official “overview” document, but it’s really not as good as it could be; it’s basically a whirlwind tour of components, and really has to be coupled with at least one other document (the design philosophies explanation) to provide the beginnings of a complete picture. I think Django could do a better job with that.

I think Pylons and TG face the same issue, though — as Mark explains, far more clearly and accurately than I ever could …

Entry published February 11, 2008. Read full entry.