WIP FOR DISCUSSION: Templates: take PR Club content from YAML header #1756
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Part of #1551
Upgrading the PR Review Club helper (
{% include functions/detail-list.md %}
) to Hugo is straightforward except for one point:Jekyll allows quoted strings to extend across line breaks, e.g.:
Hugo requires all parts of a string to be on the same line, e.g.:
It's trivial for me to go back and squash all previous review club entries to be on individual lines and to write a linter that enforces that for future review club entries. However, I like wrapping and we try to wrap everything else, so it would be a bit inconsistent. There are many possible alternative approaches (and I'm happy to discuss them), but one approach I think could be useful is for the Q&A to be written in YAML. This PR updates the most recent PR Review Club to use that approach, including providing template code that should exactly match our current layout.
Downsides:
Upsides:
Comments @stickies-v @LarryRuane and others?