Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Returned letters guidance for UI and API #5308

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

saimaghafoor
Copy link
Contributor

Updated 'Undelivered letters and returned mail' content as returned letters callback available in API.

Updated 'Undelivered letters and returned mail' content
<p class="govuk-body">Returned mail is destroyed by our printer.</p>
<p class="govuk-body">Each letter has a unique ID. Our printer sends us the ID of every letter they destroy. We’ll contact you if the IDs match any of your letters. This is a partly manual process, so it can take a few weeks.</p>
<h3 id="returned-mail" class="heading-small">Returned letters</h3>
<p class="govuk-body">Every letter we send includes our print provider's address on the back of the envelope. It’s not possible to customise the return address.</p>
Copy link
Contributor

@karlchillmaid karlchillmaid Nov 29, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<p class="govuk-body">Every letter we send includes our print provider's address on the back of the envelope. It’s not possible to customise the return address.</p>
<p class="govuk-body">Every letter we send includes our print providers address on the back of the envelope. You cannot customise the return address.</p>

<p class="govuk-body">Each letter has a unique ID. Our printer sends us the ID of every letter they destroy. We’ll contact you if the IDs match any of your letters. This is a partly manual process, so it can take a few weeks.</p>
<h3 id="returned-mail" class="heading-small">Returned letters</h3>
<p class="govuk-body">Every letter we send includes our print provider's address on the back of the envelope. It’s not possible to customise the return address.</p>
<p class="govuk-body">Undelivered letters are returned to our print provider and are destroyed.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<p class="govuk-body">Undelivered letters are returned to our print provider and are destroyed.</p>
<p class="govuk-body">Undelivered letters are returned to our print provider and destroyed.</p>

<h3 id="returned-mail" class="heading-small">Returned letters</h3>
<p class="govuk-body">Every letter we send includes our print provider's address on the back of the envelope. It’s not possible to customise the return address.</p>
<p class="govuk-body">Undelivered letters are returned to our print provider and are destroyed.</p>
<p class="govuk-body">A returned letters report is available on the dashboard. Use this report to help identify the letters returned.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I’m suggesting this change because:

  • the first sentence could be more active
  • the second sentence kinda repeats the first – or provides detail that is implicit in the first sentence
Suggested change
<p class="govuk-body">A returned letters report is available on the dashboard. Use this report to help identify the letters returned.</p>
<p class="govuk-body">You can see a report of returned letters on the dashboard.</p>

<p class="govuk-body">A returned letters report is available on the dashboard. Use this report to help identify the letters returned.</p>
<p class="govuk-body">If you’re using the Notify API, you can automate identifying the returned letters. Follow the instructions in our <a class="govuk-link govuk-link--no-visited-state"
href="https://www.notifications.service.gov.uk/using-notify/api-documentation">API documentation</a>.</p>
<p class="govuk-body">You’ll need a developer on your team to set this up for you.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As we’re describing the UI and API behaviours under a single h3, is there a risk that users could misinterpret this final line/paragraph and think it applies to all of the above?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants