Pending Box Macro

Renders a box containing a pending message to be handled later by the author.

Audience
Categories
Box / Collaboration
Tags

The documentation is created collaboratively. The pending box allows an author to add a mark for a topic to deal with later.

The author may define queries with the Display Table Macro to select pending tasks for her documents. The feedback may also be displayed with the Documentation Dashboard.

Here is an example with the Display Table Macro to show how to select the pages containing the pending boxes:

<ac:structured-macro ac:name="projectdoc-display-table">
  <ac:parameter ac:name="select">
    <at:i18n at:key="projectdoc.doctype.common.name"/>, 
    <at:i18n at:key="projectdoc.doctype.common.shortDescription"/>, 
    <at:i18n at:key="projectdoc.doctype.common.doctype"/>, 
    <at:i18n at:key="projectdoc.doctype.common.tags"/>
  </ac:parameter>
  <ac:parameter ac:name="where">macroName:projectdoc-box-pending*</ac:parameter>
  <ac:parameter ac:name="sort-by"><at:i18n at:key="projectdoc.doctype.common.sortKey"/></ac:parameter>
</ac:structured-macro>

Properties

The macro provides the following properties for configuration.

Title

The title is an optional parameter.

Here is an example with title:

Show Icon

The checkbox allows to remove the icon from the box.

Tags

Tag the box to use for transclusion.

By default the tag pending-box is added.

Details

Hint to use this box with K15t Scroll-Office

To export a page using this macro with K15t Scroll Office the Print Quirk Modes should be enabled.

Related macros

Boxes are used to add visual emphasis.

Here are boxes that help the team to create documentation collaboratively:

Fault Box Macro
Renders a box containing a fault message reported by a team member for the author.
Feedback Box Macro
Renders a box containing a feedback message from a reader with write privilege.

Here is a list of alternative boxes to use for your texts:

Name Short Description Tags
Renders a box containing a caution message.
Renders a box containing a deprecation warning for the reader.
Renders an example within a box.
Generic boxes help to easily define one's own boxes to apply certain CSS styles to them.
Renders a box containing an info message.
Renders something to note by the reader.
Renders a box containing an open question.
Renders a box with references to further information.
Renders a box with a tip for the reader.