Skip to content

docs: add webmaster instructions the single-file html#305

Open
joanise wants to merge 2 commits into
mainfrom
dev.ej/webmaster-instructions
Open

docs: add webmaster instructions the single-file html#305
joanise wants to merge 2 commits into
mainfrom
dev.ej/webmaster-instructions

Conversation

@joanise
Copy link
Copy Markdown
Member

@joanise joanise commented May 25, 2026

PR Goal?

Give webmasters a blunt message that the single-file HTML format is not intended for publication as is.

Feedback sought?

review the text

Priority?

normal

Tests added?

not needed

How to test?

readalongs align -l fra tests/data/ej-fra.txt tests/data/ej-fra.m4a delme
less delme/Offline-HTML/delme.html

and see the webmaster webmaster warning and then the webmaster instructions.

Confidence?

high

Version change?

no

Related PR

ReadAlongs/Studio-Web#554

@semanticdiff-com
Copy link
Copy Markdown

semanticdiff-com Bot commented May 25, 2026

Review changes with  SemanticDiff

Changed Files
File Status
  readalongs/text/make_package.py  28% smaller

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 25, 2026

CLI load time: 0:00.05
Pull Request HEAD: 0e6e18a99e40fa951560be5209bf91ee57d8b51f
No imports take more than 0.1 s.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 25, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.76%. Comparing base (17ceaa3) to head (0e6e18a).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #305   +/-   ##
=======================================
  Coverage   93.76%   93.76%           
=======================================
  Files          21       21           
  Lines        1765     1765           
  Branches      295      295           
=======================================
  Hits         1655     1655           
  Misses         73       73           
  Partials       37       37           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@joanise joanise requested a review from roedoejet May 27, 2026 12:05
Copy link
Copy Markdown
Collaborator

@roedoejet roedoejet left a comment

Choose a reason for hiding this comment

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

small jargon changes requested. Otherwise lgtm and this is a good addition to the file.

Comment thread readalongs/text/make_package.py Outdated
BASIC_HTML = """
<!DOCTYPE html>

<!-- DO NOT USE THIS VERSION ON A WEBSITE. See Webmaster Instructions below -->
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
<!-- DO NOT USE THIS VERSION ON A WEBSITE. See Webmaster Instructions below -->
<!-- DO NOT USE THIS VERSION ON A WEBSITE. See Web Developer Instructions below -->

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Website Administrator, Web Admin, or Web Developer are all more standard terms now.

Comment thread readalongs/text/make_package.py Outdated

<!--

Webmaster Instructions
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Webmaster Instructions
Web Developer Instructions

Comment thread readalongs/text/make_package.py Outdated
Webmaster Instructions

Before publishing this ReadAlong on a web site, please convert it to a Web
Bundle. This monolithic format is the master file for editing and for offline
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Bundle. This monolithic format is the master file for editing and for offline
Bundle. This monolithic format is the main file for editing and for offline

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