syntaxfm / syntaxfm/website

Add Validation + Checks to markdown PRs

Open
#1,538 14 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Svelte
Stars
1.2k
Forks
515
Avg merge
23h
Merged PRs (30d)
13

Description

We need to create a github action that does validation on the markdown files when we PR them. This way we can merge with confidence.

I've done this in the past with my uses.tech site: https://github.com/wesbos/awesome-uses/blob/master/.github/workflows/data-validate.yml

So, things that should be checked:

  1. Publish date is in the future
  2. mp3 url is valid (Fetch with HEAD to ensure file exists)
  3. Show number is not overlapping with any existing shows
  4. All links in markdown resolve 200 OK
  5. Perhaps some sort of spellcheck?
  6. Youtube url is a real youtube url (we had them mixed up once)
  7. all timestamp links adhere to HH:MM:SS or HH:MM

Just trying to think of others

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the referenced .github/workflows/data-validate.yml example and inspect how this repository stores markdown files and opens pull requests. Define validation for the seven listed areas, including dates, URLs, show-number collisions, YouTube URLs, and timestamp formats; done means the GitHub Action reports failures on invalid markdown changes.

Written by the indexing model from the issue text.

Assessment

Tech stack
github-actions, markdown
Domain
ci-cd, testing-qa
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.