Hi Joel,
Here is some more documentation feedback.
I found the section with Ola's suggestion a little confusing.
What does samplenote::new mean? It's not really explained anywhere, or linked in anywhere.
I'm fairly familiar with ACS, and have used OpenACS a little, and I found that section totally mysterious. Where does that definition come from? Is it a namespaces thing? I'm not really up on namespaces.
Anyway, I imagine some more explanation might be in order there. I'd offer concrete wording suggestions, but I don't understand it yet. 😊