pdf migrations #21

jamesthebrooks · 2024-10-24T15:50:02Z

Changes proposed in this pull request:

migrated pdf files from jekyll site

sknep · 2024-10-29T16:02:31Z

PDFs make me sad. Would muuuuch rather see these converted to HTML with a redirect from that path. This meets OMB M-23-22 guidance. What do we gain by checking in these PDFs?

jamesthebrooks · 2024-11-06T18:50:51Z

PDFs make me sad. Would muuuuch rather see these converted to HTML with a redirect from that path. This meets OMB M-23-22 guidance. What do we gain by checking in these PDFs?

I don't have an answer or opinion on that. That said, if we're going to do this as a feature upgrade, I would prefer to create a new ticket outside of this epic to approach that upgrade. That way we can specify both requirements and acceptance criteria without muddying the migration effort and both can have acceptance criteria. Then we can define things like PDF style guides, headers, etc. and someone on the team can have a clearly defined goal.

sknep · 2024-11-06T18:58:16Z

new ticket outside of this epic

Converting PDFs to HTML pages was always on the list of things that needed to happen for this work, as I described it a while back:

... specifically: migrate PDF content to HTML, delete the old PDFs

Either we do it now or we do it later/soon, but all PDF content needs to be remediated to HTML if we want to be compliant on this site. Can you scope how long it would take you to get a fair web experience up for this as a collection in HTML, not PDF? I understand the designs wouldn't be 1-1. Can you make an estimate of how long it would take and what state the content would be in, in terms of quality of experience?

define things like PDF style guides, headers, etc

Do you mean like... re-export the PDFs with a consistent style? OR just how the content that is currently in PDFs ends up in HTML?

apburnes · 2024-11-07T16:53:15Z

@sknep we don't have a functionality currently to redirect from the old PDFs to the new HTML page. Can we create the HTML representations of the old PDFs and leave the PDFs for now while we think about how we could accomplish it?

jamesthebrooks · 2024-11-07T17:18:57Z

For today, do we want to just copy PDF text content out and put in a file /resources/{original-file-name-without-extension}? For unlinked files, just delete them?

sknep · 2024-11-07T17:21:05Z

we don't have a functionality currently to redirect from the old PDFs to the new HTML page

Let's try with a meta refresh / redirect and see if the mimetypes mess it up: https://www.sitebuilderone.com/blog/11ty-url-redirections.html

jamesthebrooks · 2024-11-07T17:31:17Z

new ticket outside of this epic

Converting PDFs to HTML pages was always on the list of things that needed to happen for this work, as I described it a while back:

... specifically: migrate PDF content to HTML, delete the old PDFs

Either we do it now or we do it later/soon, but all PDF content needs to be remediated to HTML if we want to be compliant on this site. Can you scope how long it would take you to get a fair web experience up for this as a collection in HTML, not PDF? I understand the designs wouldn't be 1-1. Can you make an estimate of how long it would take and what state the content would be in, in terms of quality of experience?

define things like PDF style guides, headers, etc

Do you mean like... re-export the PDFs with a consistent style? OR just how the content that is currently in PDFs ends up in HTML?

Right now, I think I would like to discuss with the team. After talking with you yesterday, I was thinking that this was going to be a simpler task. None of the content seems to be duplicate for existing html pages, and after talking with @apburnes today, it doesn't seem like it's currently possible to redirect from a missing pdf anyway so we would need to spec out how that would work as well. So it seems like as of right now, what I am clear on:

~~Cannot redirect from PDFs~~
~~Can delete unlinked files that seem to be referenced nowhere~~
~~Can convert PDF content to HTML, but would like some requirements around this such as:~~
- ~~page layout and styling requirements~~
- ~~any possible requirements around images~~

~~If it's as simple as "keep paragraphs and images and forget about other details", that's good enough for me. I'd just like to know before I start.~~

Revised:

Won't be doing PDF -> HTML/MD conversions for now. Will:

delete PDFs not linked to
attempt a meta refresh if it's simple to redirect them to another page where possible. will attempt the next closest related topic

… those files

sknep · 2024-11-07T19:29:12Z

content/redirects/Office_Hours_EC_ES_Tech_Talk.html

@@ -0,0 +1,5 @@
+---
+permalink: /assets/documents/Office_Hours_EC_ES_Tech_Talk.pdf/index.html
+redirect: /docs/overview/customer-service-objectives/


lets redirect this one to: https://cloud.gov/docs/services/aws-elasticache/

sknep · 2024-11-07T19:29:54Z

content/redirects/cloudgov-vendors-2019.html

@@ -0,0 +1,5 @@
+---
+permalink: /assets/documents/cloudgov-vendors-2019.pdf/index.html


https://cloud.gov/assets/documents/cloudgov-vendors-2019.pdf doesnt' exist.... is this the right source URL?

ah, the permalink should say:

permalink: /resources/cloudgov-vendors-2019.pdf

Updated the permalink. Good catch! Where should the redirect go?

sknep · 2024-11-07T19:32:41Z

content/redirects/federalist-system-architecture.html

@@ -0,0 +1,5 @@
+---
+permalink: /assets/documents/federalist-system-architecture.pdf/index.html
+redirect: /pages/documentation/how-pages-works/


I'm asking about this one in slack. It might already exist somewhere else, like on our diagrams site at https://diagrams.fr.cloud.gov/

sknep · 2024-11-07T19:37:06Z

content/redirects/how-federalist-works-for-presentation.html

@@ -0,0 +1,5 @@
+---
+permalink: /assets/documents/how-federalist-works-for-presentation.pdf/index.html
+redirect: /pages/documentation/how-pages-works/


should this redirect to the PDF you're including at:

_assets/documents/how-pages-works-diagram.pdf

I'm not sure honestly. We can delete how-pages-works-diagram.pdf and redirect to /pages/documentation/how-pages-works/. For how-federalist...pdf, this was just a best guess.

ah, federalist is the old name of Pages, so i think it has just been replaced by newer content 2x

sknep · 2024-11-07T19:38:03Z

_assets/documents/2017-benchmarking-us-government-websites.pdf

I think we should definitely delete this one! no redirect! into the ether!

sknep · 2024-11-07T19:38:49Z

_assets/documents/AFWERX-case-study.pdf

Let's delete and redirect this one to https://cloud.gov/pages/success-stories/#afwerx

sknep · 2024-11-07T19:40:33Z

_assets/documents/Federalist-ATO-Extension-Letter.pdf

Let's delete this one and redirect to https://cloud.gov/pages/documentation/security-and-compliance/

sknep · 2024-11-07T19:41:31Z

_assets/documents/Pages-Proposal.pdf

let's delete and redirect this one to the pages homepage, cloud.gov/pages

sknep · 2024-11-07T19:41:58Z

_assets/documents/afwerx-success.pdf

Let's delete and redirect this one to https://cloud.gov/pages/success-stories/#afwerx

sknep · 2024-11-07T19:44:34Z

_assets/documents/cloud-gov-benefits-of-enterprise-solution.pdf

lets delete and redirect to https://cloud.gov/pricing/

sknep · 2024-11-07T19:44:54Z

_assets/documents/coe-success.pdf

https://cloud.gov/pages/success-stories/#centers-of-excellence

sknep · 2024-11-07T19:45:06Z

_assets/documents/doi-success.pdf

https://cloud.gov/pages/success-stories/#department-of-the-interior

sknep · 2024-11-07T19:45:59Z

_assets/documents/pages-compliance-memo.pdf

https://cloud.gov/pages/documentation/security-and-compliance/

sknep · 2024-11-07T19:50:44Z

_assets/documents/example-diagram-1.pdf

these diagrams might not have a good replacement, in which case a ticket for me to rebuild them in something accessible is the right call. do you know where these are used?

Seems like this is the only place they're referenced: https://cloud.gov/docs/compliance/diagrams/

sknep · 2024-11-12T16:30:34Z

_assets/documents/how-pages-works-diagram.pdf

cloud-gov/system-diagrams#164

I don't expect this to get closed soon, so we can keep this diagram for now. When that ticket is addressed, we can come back to this.

sknep

I think this is shippable!

btw next time -- feel free to dismiss and re-request reviews if you're waiting to hear back, I didn't realize you were done and waiting on me

jamesthebrooks changed the title ~~df migration~~ pdf migrations Oct 24, 2024

jamesthebrooks requested review from apburnes and sknep October 24, 2024 17:04

jamesthebrooks force-pushed the chore-pdf-migration branch from acd4eb1 to 5355e71 Compare October 28, 2024 15:31

jamesthebrooks force-pushed the chore-pdf-migration branch 3 times, most recently from 26e9a85 to db8d87e Compare October 30, 2024 17:30

migrated pdf assets

9ae0122

jamesthebrooks force-pushed the chore-pdf-migration branch from db8d87e to 9ae0122 Compare November 7, 2024 16:00

added external link class to footer link

f89b884

jamesthebrooks added 2 commits November 7, 2024 14:19

adding redirects for files that are no longer referenced and deleting…

e0f030f

… those files

added layout for redirect page

e92b5ba

sknep reviewed Nov 7, 2024

View reviewed changes

Removing PDFs in favor of redirecting to html pages

04edd34

sknep reviewed Nov 12, 2024

View reviewed changes

sknep self-requested a review November 12, 2024 16:31

sknep approved these changes Nov 12, 2024

View reviewed changes

jamesthebrooks merged commit fbffc32 into main Nov 12, 2024
3 checks passed

sknep deleted the chore-pdf-migration branch November 12, 2024 17:36

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

pdf migrations #21

pdf migrations #21

jamesthebrooks commented Oct 24, 2024

sknep commented Oct 29, 2024

jamesthebrooks commented Nov 6, 2024

sknep commented Nov 6, 2024 •

edited

Loading

apburnes commented Nov 7, 2024

jamesthebrooks commented Nov 7, 2024

sknep commented Nov 7, 2024

jamesthebrooks commented Nov 7, 2024 •

edited

Loading

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

jamesthebrooks Nov 8, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

jamesthebrooks Nov 8, 2024

sknep Nov 12, 2024

sknep Nov 7, 2024 •

edited

Loading

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

sknep Nov 7, 2024

jamesthebrooks Nov 8, 2024

sknep Nov 12, 2024

sknep left a comment

		@@ -0,0 +1,5 @@
		---
		permalink: /assets/documents/cloudgov-vendors-2019.pdf/index.html

pdf migrations #21

pdf migrations #21

Conversation

jamesthebrooks commented Oct 24, 2024

Changes proposed in this pull request:

sknep commented Oct 29, 2024

jamesthebrooks commented Nov 6, 2024

sknep commented Nov 6, 2024 • edited Loading

apburnes commented Nov 7, 2024

jamesthebrooks commented Nov 7, 2024

sknep commented Nov 7, 2024

jamesthebrooks commented Nov 7, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sknep Nov 7, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sknep left a comment

Choose a reason for hiding this comment

sknep commented Nov 6, 2024 •

edited

Loading

jamesthebrooks commented Nov 7, 2024 •

edited

Loading

sknep Nov 7, 2024 •

edited

Loading