suggestions from review

[padmashris]

• adding back Google Forms and Slido
• filling out the remaining subsections on the homepage
• updating template URL

[github-actions]

OTTR Check Results

Summary

• Spelling check: ✅ PASSED (0 errors found, threshold: 0)
• URL check: ✅ PASSED (0 errors found, threshold: 0)

🎉 All checks passed!

Last Updated: 2026-06-10-14:56:09

[github-actions]

Re-rendered previews from the latest commit:

• 👀 Quick preview of course website here *
• 🔬 Comprehensive download of the course website here
• Download the .docx file

* note not all html features will be properly displayed in the "quick preview" but it will give you a rough idea.

Updated at 2026-06-10 with changes from the latest commit f33e5c2

[carriewright11]

Looks good to me! @kweav what do you think? I know we need to add some disclaimers about what functionality is still in the works for some of these, but I do think it is good to set this up as is and add a box to those once we have tested some more.

[kweav]

We'll need to update this since a second secret is what metricminer expects METRICMINER_GITHUB_PAT for fetching data from GitHub while OTTR expects the GH_PAT for just general OTTR tasks (checks and rendering)

[kweav]

I think we need a drive name instead of a drive_id now because of the changes we had to make to the function

[kweav]

Made some comments on the instructions.

As for the specific pages/preview (like Google Forms)--

1. should we add a note that metricminer isn't going to remove any identifying information that may be included (like in Slido or Calendly meeting notes, etc.)
2. The google forms one still has that bug where the question names aren't part of the metricminer results output, but I know we're working on a fix for that
3. I was really surprised that slido was getting data to display but went looking and it's using 2 year old data. A couple of notes -- we'll need a drive name instead of a drive ID to get new data. I don't have access to the drive ID that is listed in the refresh script, so I can set up another test drive and put test data there if needed

[carriewright11]

Made some comments on the instructions.

As for the specific pages/preview (like Google Forms)--

1. should we add a note that metricminer isn't going to remove any identifying information that may be included (like in Slido or Calendly meeting notes, etc.)

2. The google forms one still has that bug where the question names aren't part of the metricminer results output, but I know we're working on a fix for that

3. I was really surprised that slido was getting data to display but went looking and it's using 2 year old data. A couple of notes -- we'll need a drive name instead of a drive ID to get new data. I don't have access to the drive ID that is listed in the refresh script, so I can set up another test drive and put test data there if needed

Thanks for these comments! Yes, I think we should mention all of this. I think Padma can add this and do more Slido tests too

[jhudsl-robot]

Overall readability score: 52.48 (🔴 -0.37)

File	Readability
README.md	78.6 (🔴 -0.73)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
README.md	78.6	57.06	7.34	9	9.62	5.69
	🔴 -0.73	🔴 -0.1	🔴 -0.09	🔴 -0.2	🔴 -0.17	🔴 -0.01

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	52.48	30.52	10.85	12.65	13.57	7.2
	🔴 -0.37	🔴 -0.05	🔴 -0.04	🔴 -0.1	🔴 -0.09	🔴 -0.01

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less