I've been giving everything a unique name. I actually don't like the
"databinding" inside of "netui" in site.xml. I think we should try an make
these unique or use real xpath expressions in our hrefs. Things like
"databinding" and "overview" are pretty generic. I think if we go to the
generic terms we have to rework our "site:" expressions to put in the proper
xpath, but I'm not sure that Forrest supports real xpath expressions in the
"site:xxx", but I believe it does. I don't see something like
("site:/netui/databinding") instead we are using ("site:databinding") which
seems like it will break at some point.
On 8/31/05, Eddie O'Neil <[EMAIL PROTECTED]> wrote:
>
> Steve--
>
> Great to have some "professional" edits to the documentation. :)
>
> A few comments on some of the changes made here which we might take
> a closer look at:
>
> 1) I think your editor is tab-ifying some of the documentation. We're
> standardized on using four spaces rather than tabs for the doc. This
> happened at least in xdocs/netui/overview.xml
>
> 2) unless there is formatting (like <strong>) that is used inside of
> JSP content, it's much easier to write documentation using "<"
> characters than <. This makes copy/paste from samples simpler
>
> 3) when referring to NetUI, we tend to use the term "NetUI" rather
> than "Netui". This happened in the labels in site.xml. Also, in this
> case, it seems like we can call the NetUI Overview section just
> "Overview" since it's under the NetUI tab already. I've tried to
> remove some of that reduncancy from the docs in recent weeks.
>
> Thoughts?
>
> Eddie
>
> On 8/31/05, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote:
> > Author: steveh
> > Date: Wed Aug 31 16:09:14 2005
> > New Revision: 265602
> >
> > URL: http://svn.apache.org/viewcvs?rev=265602&view=rev
> > Log:
> > Editing run-through.
> >
> > Modified:
> >
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/controls/tutorial_controls.xml
> >
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/getting_started.xml
> >
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/jspOverview.xml
> >
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/overview.xml
> >
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/pageFlowControllers.xml
> >
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/projects.xml
> >
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/site.xml
> > beehive/trunk/docs/how_to_contribute_docs.txt
> >
> > Modified:
> beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/controls/tutorial_controls.xml
>
