Henri Bergius wrote:
> However, if we are to use CommenText for our documentation
> needs, we will need to integrate it with the Midgard site
> so that they can share authentication information, and we
> can interface with the CommenText system more easily.
This shouldn't be a problem.
> Also, I think that we will still need the annotations system.
> CommenText is still a bit too difficult to use for a casual
> user who happens to get an addition idea while browsing the
> documentation. How to link this with the CommenText system
> is left to be decided.
>
> Paul, what do you think, is this feasible?
Presently the only way you can add comments to a section
of the document easily (i.e., without creating a new version)
is to submit a linked post. That's a transient form of annotation,
since links to posts are not automatically propagated when
you create a new version of the document component that
the post is linked to. The assumption is that when you create
a new version, you are taking on the responsibility to
incorporate any of the content of the linked threads that
you deem to be worth preserving into the document itself.
If not, a new link to the relevant thread can be created
manually after the new version has been created.
There's also a 'commentary' subarticle type that can be used
to add personal experiences and observations, but this requires
creation of a new version of the relevant section of the
document.
I suppose it would be possible to create a class of posts to
the forum specifically for annotation, and change the linking
rules to automatically propagate links to such posts into
new versions. But it's arguably cleaner to maintain a viewpoint
that dialog should be a transient path into revised documentation.
Paul N.
http://www.commentext.org
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
