Update content for the business readiness finder
The business readiness finder relies on metadata tags in rummager to filter content.
Content is curated and added to a spreadsheet by the content team. Developer help is needed to upload the content. We do this by converting the spreadsheet into a CSV, including it in govuk-app-deplopment-secrets and then releasing rummager.
The process of converting the spreadsheet into a CSV involves removing a header row and converting windows encoded line breaks if present. There is a script to do this.
Make sure the “List of documents with facets” tab is selected and download the spreadsheet as csv:
Create a pull request and get it reviewed & merged.
Re-deploy rummager/search-api and email-alert-api via Jenkins.
tag_metadatarake task in rummager/search-api to index the contents of the new CSV, it should take 2 to 3 minutes:
Check the results on e.g. https://www-origin.integration.publishing.service.gov.uk/find-eu-exit-guidance-business
These requests often come in through Zendesk and for pages that have only been created that same day, so you may only be able to check this in production.
Removing content from the business readiness finder
If your commit includes some items being removed from the content spreadsheet then you should take a note of the
base_paths for these items and once you have run the
tag_metadata rake task in the above instructions, you should also run destroy_metadata_for_base_paths (e.g. on staging), passing in the
base_paths that need removing.
There are also other useful rake tasks. Remember to redeploy apps and re-run the
tag_metadata task as above.
Pinning content to sections in the business readiness finder
Requests from Zendesk can specify that content is pinned within the finder. Pinning an item means that it appears at the top of whatever business finder facet(s) it is tagged to. The process for adding a pinned item:
- Using the base path of the content item to be pinned, get the content id. You can do this via the publishing-api:
- Add the content id to the list of ordered related items for the business finder, within govuk-app-deployment-secrets. Despite the name, the order of the
ordered_related_itemsdoes not matter.
- Create a pull request and get it reviewed & merged.
- Re-deploy rummager.
- Update the finder content by running the [
tag_metadatarake task][staging-rake-task] in rummager to index the contents of the new CSV, it should take 2 to 3 minutes.
- Republish the finder so that the finder content item is updated.
- Check the results on e.g. https://www-origin.integration.publishing.service.gov.uk/find-eu-exit-guidance-business
The same process applies for removing a pinned item: get the content item and remove it from the list within the ordered-related items.