Merge pull request #10127 from alphagov/documentation-for-assets

Amend assets documentation

Author: minhngocd

docs/assets.md

@@ -214,25 +214,26 @@ Last updated: 3rd April 2025
 **How to reproduce:** 
 
 1. Unpublish an edition that has an attachment
-2. Create a new draft
-3. Preview the attachment
+1. Create a new draft
+1. Preview the attachment
 
 **What happens:** 
 
-1. Attachment preview is redirected
+* Attachment preview is redirected
 
 **Expected:** 
 
-1. Draft Attachment should be previewable
-2. Live attachment should still be redirected
+* Draft Attachment should be previewable
+* Live attachment should still be redirected
 
 **Suggested Support Fix:** 
 
 * There is currently no fix. If we make the asset state `draft` in asset-manager, then any previous asset in the replacement chain (if it exists) will become live, which might not be what the user wants.
 * One thing we can do is to check whether or not the attachment users want to preview is not a replacement of any prior assets. We can do this by double checking in both Asset in Asset Manager and AttachmentData in Whitehall that no other assets are replaced by this  target attachment. If that is the case, we should be able to set the state of the asset to `draft` in Asset Manager which should enable preview for the user.
 
 **Suggested Permanent Fix:**
-Having a draft stack for attachments will help. If we duplicate assets for draft, then it won't affect anything live. 
+
+* Having a draft stack for attachments will help. If we duplicate assets for draft, then it won't affect anything live. 
 
 ---
 
@@ -241,32 +242,28 @@ Having a draft stack for attachments will help. If we duplicate assets for draft
 **How to reproduce:**
 
 1. Unpublish an edition with attachment
-2. Create new draft
-4. Discard the draft
-5. Create new draft
-6. Publish the draft
+1. Create new draft
+1. Discard the draft
+1. Create new draft
+1. Publish the draft
 
 **What happens:**
 
-1. Attachment returns not found
+* Attachment returns not found
 
 **Expected:**
-
-1. Attachment should be made live again upon publish
+* Attachment should be made live again upon publish
 
 **Suggested Fix:**
 
-1. Reset redirect url and / or deleted_at in Asset Manager for the appropriate asset to bring it back
-
---
+* Reset `redirect url` and / or `deleted_at` in Asset Manager for the appropriate asset to bring it back
 
 ### Current unsupported workflows
 Last updated: 3rd April 2025
 
 We currently don't support official UI workflow for doing the following.
 
-- Redirect individual attachments
+- Unpublish / Redirect individual attachments
   - For HTML attachments, rake task `publishing_api:redirect_html_attachments:by_content_id`
   - For file attachments, manage in asset manager
-- Withdraw individual HTML attachments
-- Unpublish individual HTML attachments
+- Withdraw individual HTML attachments