Web-stories-wp: Pre-Publish Checklist: Update warning about story description to provide guidance to resolve

[bmattb]

Feature Description

Currently when a creator has not provided a story description the prepublish checklist provides a Recommendation as follows:

However, there is no guidance provided on where to set this.

Additionally, this field is referred to as "excerpt" in the document panel, so there should be some alignment between the field name and the recommendation verbiage.

Alternatives Considered

Additional Context

---

_Do not alter or remove anything below. The following sections will be managed by moderators only._

Acceptance Criteria

Implementation Brief

[BrittanyIRL]

@o-fernandez - do you mind providing some updated copy for this?

[o-fernandez]

I think that what we need to do is rename "Excerpt" to be Story description, per this thread

If we have the functionality, then "Story description" could be a clickable link that takes you to the right field directly, but that's not necessary for this ticket if not easily feasible.

@samitron7 @choumx FYI and for any add'l comment.

[o-fernandez]

Ok, agreed in the thread to:

• Update Excerpt under Document tab to be Story Description
• Correspondingly, we can update this pre-publish checklist text to say: Missing Story Description (capitalized to match the field) and the help text can be Add a Story Description in the Document panel which would direct people to look at the Document panel, I hope.

@BrittanyIRL does this work?

[BrittanyIRL]

@o-fernandez perfect, thank you!

[BrittanyIRL]

@o-fernandez - one thing to clarify before UAT

the placeholder text here: "Write an excerpt" and the helper text "Stories with an excerpt tend to do better on search and have a wider reach" - I left these as excerpt because the story itself refers to this as an "excerpt" not a "description" so I thought that having "description" here with the labeling and then "excerpt" in the associated helper text ties the two together. Let me know if you want something different.

[choumx]

IMO we should change "excerpt" to "story description" as well.

Story Description
Write a description of the story
Stories with a description tend to do better on search and have a wider reach.

[BrittanyIRL]

@choumx @o-fernandez - this good?

[o-fernandez]

@choumx @o-fernandez - this good?

Yeah, looks great!

[BrittanyIRL]

@csossi for testing, the accurate text updates by screenshot are in the PR: https://github.com/google/web-stories-wp/pull/5557

[csossi]

Verified in QA

[swissspidy]

Ok, agreed in the thread to:

• Update Excerpt under Document tab to be Story Description
• Correspondingly, we can update this pre-publish checklist text to say: Missing Story Description (capitalized to match the field) and the help text can be Add a Story Description in the Document panel which would direct people to look at the Document panel, I hope.

Just noting that Add a Story Description in the Document panel. uses some unusual capitalization. It's not even title case.