nunit / nunit/docs

Spell-checking forces text of user issues to be changed in the release notes/

Open
#694 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area:build-and-deploy pri:p2
Dominant language
Dockerfile
Stars
600
Forks
158
Avg merge
16h 8m
Merged PRs (30d)
21

Description

I'd say this is fairly minor and depends on the policy of each project regarding spelling of the text in user issues.

My own policy in the engine project (and the whole project when I was responsible for it) was always to keep the exact text entered by the user unless it wasn't understandable at all. (In that case I'd change it and add a comment to the issue) I felt (and still do) that it was disrespectful to "correct" trivial errors made by the user...

The user descriptions live in the GitHub issues database. When creating releases, they are copied verbatim to the Release Notes on GitHub by an automatic process. Creating release notes on the website is currently a manual process, which I do using cut and paste from GitHub. In future, I would have wanted to automate it.

Whether done manually or not, however, the issue descriptions, which are listed in two places in GitHub are sometimes invalid for the release notes on the website and must be changed. This bothers me a bit because the description of a given issue is now in three places and one of them is different. I'd suggest eliminating spell checking on the release notes if that's easy to do.

Contributor guide

Open the contributing guide

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 with the release-note process described in this issue, including the GitHub release notes and the website's manual copy-and-paste step. Determine where spell-checking changes issue text and whether that process can preserve the original wording; done means release notes no longer require altering copied issue descriptions.

Written by the indexing model from the issue text.

Assessment

Tech stack
github
Domain
documentation
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.