> You want outsiders to participate (think: new employees)? Write all documentation yourself, too!) Shouldn't you be doing this anyway? Not trying to be snark

> You want outsiders to participate (think: new employees)? Write all documentation yourself, too!) Shouldn't you be doing this anyway? Not trying to be snarky: it's that every job I've worked at has a classic underdocumentation problem. Tribal knowledge dominates, and the practicalities of shipping product overrun the need for teaching employees, new and old, about the idiosyncrasies of the system. [edit] This seems hardly an issue with LISPs or DSLs in particular.