microsoft / microsoft/TypeScript-Sublime-Plugin

Suggestion: Separate syntax coloring options for JavaDoc comments and regular comments

Open
#291 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Enhancement
Dominant language
JavaScript
Stars
1.7k
Forks
236
Avg merge
21d 13h
Merged PRs (30d)
1

Description

Visual Studio has this for XML doc comments and normal comments in C#.

Rationale: I (and others) tend to use JavaDoc/XmlDoc comments on top of methods as a way to create visual separation between methods, even if there is no comment. These get muddy when they're the same color as the nested comments.

screen shot 2015-07-14 at 8 18 03 pm

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 locating the repository's syntax-coloring configuration and how it distinguishes comment forms. The issue provides no file, test, or entry point, so first determine where JavaDoc/XML-style comments and regular comments are defined. Done means the two comment types have separate configurable colors, with coverage for the new distinction.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
tooling
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.