corona-warn-app / cwa-documentation

Project overview, general documentation, and white papers. The CWA development ends on May 31, 2023. You still can warn other users until April 30, 2023. More information:
https://coronawarn.app/en/faq/#ramp_down
Apache License 2.0
3.28k stars 345 forks source link

markdown-spellcheck outdated and .spelling dictionary unmaintained #891

Closed MikeMcC399 closed 2 years ago

MikeMcC399 commented 2 years ago

Problem description

The npm package markdown-spellcheck is involved in Dependabot alerts:

Alert Severity Requires markdown-spellcheck *
Prototype Pollution in async High "async": ">=2.6.4" @2.6.3
Inefficient Regular Expression Complexity in marked High "marked": ">=4.0.10" @0.3.19

* Note that interdependencies affect the final outcome of the latest possible version possible. Use for example npm ls async to check.

Background

The cwa-documentation repository uses the npm package markdown-spellcheck version 1.3.1. This is the latest available version and it was published 5 years ago.

Although the Development on documentation instructions refer to spell-checking in the course of document submission, in practice the .spelling dictionary has not been updated for the last two years and is de-facto unmaintained. If npm run spellcheck is now run it produces an error message 242 spelling errors found in 15 files.

markdown-spellcheck is not capable of spell-checking in German.

Steps to reproduce the issue

Expected behavior

Possible Fix

markdown-spellcheck has not been used for the last two years and nobody is maintaining the spelling dictionary. The package itself is 5 years old with very low likelihood of a new release. In the workflow .github/workflows/checks.yml spell-checking is already disabled.

To resolve, I suggest:

Documentation submitters can use alternative spell checkers in future such as Spell Right for Visual Studio Code which can spell check in English and German.

MikeMcC399 commented 2 years ago

If the Open Source Team agrees to remove markdown-spellcheck from this repository, I am happy to submit a PR to implement the change.

I accidently submitted this issue as a bug. Please adjust the labels accordingly. My apologies!

larswmh commented 2 years ago

@MikeMcC399 thank you for bringing this up and offering to submit a PR to implement the change. We would greatly appreciate a PR for this!


Corona-Warn-App Open Source Team

MikeMcC399 commented 2 years ago

@larswmh

Thank you for the confirmation! I have submitted:

to resolve this issue