On Sat, Nov 27, 2010 at 8:23 AM, Bob Harner <[email protected]> wrote:
> Hi Everybody! > > I've spent a lot of time over the last several days on small "style" > fixes to the documentation -- misspellings, grammar, broken links, > paragraph wrapping & formatting. In all, there have been many > hundreds of such small changes. There is more to do there, but I think > the bulk of that work is close to being done now. > I've been watching the changes, and this is great! It's a lot of work to be sure, but it can be spread out, especially with the lower restrictions needed to update the wiki (vs. commit code). > > I also went through the huge "Tapestry Web Site Updated" thread and > wrote down all of the suggestions that haven't already been > implemented. I'm sure we don't want a JIRA issue for each suggestion, > so I just put them in a wiki page "task list" under the "sandbox" > tree: > > > https://cwiki.apache.org/confluence/display/TAPESTRY/Documentation+Improvement+Tasks > > I hope people feel free to add or remove items from this list. Or > maybe there's a better tracking mechanism for these small items? > > Some questions for all of you: > > 1) Should we say "the Inject annotation", or "the @Inject annotation"? > I have seen it both ways and have generally used the second because > it seems to me more clear. > I've been trying to standardize on the second: "the @Inject annotation. If we turn that into a link, I think the @ should be outside the link: "the @[http:/...Inject.html|Inject] annotation". > > 2) The documentation had several ways of referring to Howard: "HLS > prefers...", "Howard prefers...", "I prefer...". In most cases I have > preferred either "Howard prefers..." or switched to the non-personal > "we ..." where it didn't seem to matter. What's the right way? > Howard, what do you prefer? > I prefer the title "Most Magnificent Leader, Great Teacher, Instructor In All Things Code, and Dictator For Life, the Most Regal Howard M. Lewis Ship" but that get's a bit tedious. "Howard" or "We" will do fine. > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > > -- Howard M. Lewis Ship Creator of Apache Tapestry The source for Tapestry training, mentoring and support. Contact me to learn how I can get you up and productive in Tapestry fast! (971) 678-5210 http://howardlewisship.com
