Peach / Docs / Content Engine

The outline, the article and quality checks

Edit the outline before anything is written, then review the article against checks that run on every save.

Updated

In short. The outline is where you steer. Change the headings, attach links and add notes for each section before the article is written. The finished article is checked automatically, and the checks run again every time you save an edit.

The outline

An outline is the title and the list of sections. Everything in it can be edited, and editing is free.

For each section you can change:

  • The heading.
  • The link. A page that section should link to. Peach assigns links to the sections they fit, and you can reassign, clear or replace them.
  • Notes. A statistic, a customer story or a specific claim to work into that section.

You can also set the word count and the call to action for this one article, without changing your defaults.

Writing the article

Choose Approve & write. Writing takes one to three minutes. A progress box explains what is happening, and the article opens by itself when it is ready.

Each body section of an Article or How-to researches its own sources on the web and cites real published findings with links. When nothing reliable is found, the section makes its point without a number. It does not estimate one.

Writing counts as one article against your monthly quota.

The editor

The article opens in an editor with headings, bold and italic, lists, links and tables. The title is editable.

Edits save automatically. There is no Save button. A status line shows whether your changes are saved.

Articles are stored as Markdown, which is what gets published.

Quality checks

Every article is checked when it is written and again on every save. The result is Pass or Needs review.

Check What it looks for If it fails
Word count Length within the band for the format Needs review
Banned phrases Stock filler phrases Needs review
Outline coverage Every outline heading is present Needs review
Call to action The closing call to action is there, with a real link Needs review
Brand mentions Your brand is not repeated too often for the length Needs review
Unresolved placeholders Bracketed text that was never filled in, such as a literal [link] Needs review
Homepage citations A source link that points at a site's front page Flagged only
Sourcing How many sections were written with web sources Reported only

Word count bands

Format Band
Article 1,500 to 2,600 words
How-to 2,000 to 4,000 words
Listicle 2,500 to 6,000 words

Brand mentions

The limit scales with length: about eight mentions per thousand words, and never fewer than six allowed. A long article naming you nine times is normal. A short one naming you twenty-eight times is stuffing.

Sourcing

Web research sometimes fails for a section, and Peach then writes that section without sources. The sourcing line tells you how many sections were researched and names the ones that were not, so an unsourced section never looks the same as a sourced one.

Reading "Needs review"

"Needs review" means a check failed. Open the article to see which one. It is a prompt to look, not a block on publishing.

A listicle can land slightly under its 2,500-word floor and be flagged on length alone. That floor is being re-examined.

What the checks do not do

The checks count and match. None of them reads a sentence for sense, accuracy or tone. Read the article before you publish it.