Article Standards

When writing and reviewing your articles please stick to the following standards:

General

Always use proper spelling and grammar.

Links

Always link to internal Grooper Wiki articles using the [[Article Name]] syntax. Ex:

Tabular Layout
[[Tabular Layout]]

For external links either:

Use the full text link
- https://www.grooper.com
- https://www.grooper.com
Or, use the nickname syntax Grooper
- Grooper
- [https://www.grooper.com Grooper]
NEVER use the footnote syntax
- [1]
- [https://www.grooper.com]

If a linkable topic exists multiple times in an article, link the word or phrase the first time it appears in an article's section.

Linking to an article more than once per section crowds the topic and makes it more difficult to read.
Visit the Article Formatting#Links page for more information.

Bolding and Italics

Bold all Grooper objects

What's an object? A good rule of thumb is anything you can add to the Node Tree is an object.
Ex: Batch, Batch Folder, Batch Page, Value Reader, Content Model, Data Model, Document Type

Bold and Italicize all Grooper properties

What's a property? Anything in a property configuration grid.
Ex: A Value Reader only has one configurable property, the Extractor Type property.

Italicize all Grooper property settings in "How To" sections.

Ex: On the Data Field, set the Display Width to 200

When referring to a property selection that has sub-property configurations, keep that property in bold italics.

For example, Pattern Match is an Extractor Type.
- It is not a Grooper object. So, it should not be bolded.
- But it is more than just a simple property configuration. It is a set of properties.
  - Pattern Match makes it more visually apparent that it is a set of properties.
  - Pattern Match gives the impression that it is something simple like a true/false value or a simple dropdown choice that requires no further configuration.
Other examples include: Labeling Behavior, Ordered Array, Tabular Layout

BE AWARE: This guidance has not always been followed in the past. You may find older examples in the wiki that do not follow this advice. Any author may correct an articles bolding and italic convention at any time.

Grooper ZIPs

Include links to download Grooper content the reader can import into their own Grooper environments.

Use the following information box format:

{|class="download-box"
|
[[File:Asset 22@4x.png]]
|
You may download the ZIP(s) below and upload it into your own Grooper environment (version 2023).  The first contains a '''Project''' with resources used in examples throughout this article.  The second contains one or more '''Batches''' of sample documents.
* [[Media:2023_Projects_Wiki_-_Article_Name.zip]]
* [[Media:2023_Batches_Wiki_-_Article_Name.zip]]
|}

You may download the ZIP(s) below and upload it into your own Grooper environment (version 2023). The first contains a Project with resources used in examples throughout this article. The second contains one or more Batches of sample documents.

Where does this box go?

This should be the first thing the reader sees before the first level 2 heading (usually the "About" section).

Should this be configured or unconfigured content?

This content should be configured content.
The only exception is for resources such as CMIS Connections that contain sensitive connection info to external systems. Either do not include this content in the ZIP or leave it unconfigured.

How many Grooper ZIPs should I include?

Most typically you will link to a maximum of two (2) files:
One Grooper ZIP for Batches containing any documents shown in the article. Use the following naming format:
- VersionNumber Batches - Wiki - Article Name.zip
One Grooper ZIP for Projects containing any resources shown in the article. Use the following naming format:
- VersionNumber Projects - Wiki - Article Name.zip

What if I have multiple Batches I need to upload?

Put them in a folder in Grooper and export the folder.

What if I have multiple Projects I need to upload?

Put them in a folder in Grooper and export the folder

What if I don't reference the Grooper UI in my article at all?

In cases where articles do not reference the Grooper UI, you don't need to include a Grooper ZIP file.

What if I only have screenshots of one Batch?

Size does not matter.
Even if its just a single Batch with a single document, ZIP it up, and include it.

What if I only have screenshots of a single object, like just one Value Reader?

Size does not matter.
Even if it's a single node, put it in a Project, ZIP it up, and include it it.