FWIW, we've been talking about building a tool for browsing help files
for user docs.
Maybe there's an opportunity to create something that'd work for all
of these options? I put it on hold because I really wanted it to be a
Laszlo app, atleat for the user piece, and haven't had time to really
think it through.
Seems like something like the Apple help viewer app, but in Laszlo,
might be a nice tool for the toolbox. and the database in the disto,
we could base the content on XML/HTML/XHTML/Whatever, and use the Db
for meta data as useful...
On May 25, 2008, at 6:24 PM, David Temkin wrote:
This is not related to the documentation effort. The database is
being put in the distro so that LZProject (an end-to-end reference/
example app) can go in, since it requires the presence of a DB and
we don't want to require casual developers to install a separate DB.
If a comment-generation tool were to be written, it could leverage
this library... nothing more.
On May 25, 2008, at 6:29 AM, Sebastian Wagner wrote:
maybe its better to store the comments in files instead of a
database? That way people do not need to set up a database
connection for the doc-tool. If you redistribute the Docs with the
Platform people could run it out of the box without configuration.
You just have to figure out something clever for the naming
strategy of these files and folders.
For the iFrame you could take simple velocity-templates and people
can style them in their needed design.
sebastian
2008/5/25 Henry Minsky <[EMAIL PROTECTED]>:
I wonder if we could make a general purpose "doc comment" tool,
which is an iframe or something in each doc page that
fetches,displays, and accepts comments. It could store the doc
comments in a database, keyed by some keyword from the doc page.
That would de-couple it from the doc tools chain,
and also potentially make it useful for other applications as
well...
--
Chuq Von Rospach
Webmaster, Laszlo Systems.
[EMAIL PROTECTED]
