This wiki space contains archival documentation of Project Bamboo, April 2008 - March 2013.
This recipe lets users of biographical encyclopaedias add comments to published entries
in the form of annotations. Annotations are commentary on existing material or
designated parts, and do not change the published content itself. Some annotations
contain new information or corrections that are eventually incorporated as changes to the
entry. Others contain information or opinions useful to other users of the encyclopaedia
when read in parallel with the published entry, but not sufficiently germane or
authoritative to be incorporated into the entry.
Allowing annotations on entries helps researchers by improving the flow of back from
the audience. It is much more efficient than processing emails in which the writer
attempts to define the entry in question and relevant section thereof. Conversely, it can
also serve to provide more control and traceability to an existing workflow of "anyone
can edit anything".
The "Collaboration" recipe describes the process of creating entries collaboratively, with
While this recipe has been written as an extension of the recipe for contributing to a
biographical encyclopaedia, it really describes the steps needed to support annotation of
any published content, including blogs, where the annotation takes the form of a
Annotations could be simple text-editing boxes with some html editing features, eg, to
enable addition of a link, or they could be full WYSIWIG editors supporting the
uploading of images and other media. Annotations may be associated with the whole
entry, or with selected fields or with character strings in selected fields, depending on the
sophistication of the application. Entries that are candidates for annotation in a
biographical encyclopaedia may include topics or resources.
The capacity to annotate an annotation would enable an application to support threaded
discussions and may need to be limited to a specified number of levels.
Spam detection may be used as a first-level moderation method, even if annotations can
be published directly. In this case a user with moderation privileges will need workflow
support for reviewing and deleting or releasing the quarantined annotations.
Contributors may annotate in-process entries for themselves or other contributors using
the same steps. They may also annotate published entries if they wish to expose an issue
of interest or an association that is not yet ready to be incorporated in the entry itself. A
contributor annotating a published entry may by-pass moderation.
In order to respond privately to comments in annotations, the moderator will need to
know something about the annotator; eg by requiring an email address to be entered.
Annotators wishing to browse all of their annotations may associate themselves with the
biographical encyclopaedia through a lightweight user registration process that stores the
email address. This may give them other privileges, eg the ability to receive newsletters
or tailor their view of the service, or build and annotate their own views of the published
registry. In the latter case, the annotation process would be a form of bookmarking and
might also involve tagging and the creation of additional metadata and associations.
In a federated environment where entries have been harvested and/or syndicated,
annotations may be made to the same content in different contexts; eg, an entry for a
person in the Australian Women's Register may be harvested for the People Australia
Service and annotated there, or vice versa. This may require support for the syndication
and harvesting of annotations.
If the contributor is allowed to create new entries, or directly insert text into existing
entries (even if not immediately published), this is considered "collaborative editing"
rather than "annotating". See "Collaborate on a biographical database" recipe.
This section is administrative and not necessarily for academics. It is where the concrete connections are made to Scholarly Narratives and Activites.
List of the Scholarly Narratives from which this was drawn.
List of the Shared Services Activies which are called for in this Recipe.