Make grammar styling a bit nicer
Open
Nobody has claimed this yet.
feature
- Dominant language
- TypeScript
- Stars
- 245
- Forks
- 80
- Avg merge
- 10h 46m
- Merged PRs (30d)
- 2
Description
http://tc39.github.io/ecmascript-asyncawait/#AsyncFunctionDeclaration-static-semantics could be prettier:
Some ideas (brainstorming):
- Don't allow breaking in component parts, e.g. "[no LineTerminator here]" should always stay on one line.
- New line and indent after the colon?
- Turn off linebreaking entirely? (Be careful this doesn't break mobile.)
- Try to make line breaks consistent, either by the author inserting them or by some heuristic? E.g. a line break before each of "function" and "{AsyncFunctionBody}" might work.
- Change the font or font color or...?
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the AsyncFunctionDeclaration example linked in the issue and compare its rendered grammar styling with the attached screenshot. The issue presents several competing ideas rather than a decided change, so the work is done only after a specific styling approach is agreed and its effect on mobile is checked.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100