Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jslint-org/jslint
JSLint, The JavaScript Code Quality and Coverage Tool
https://github.com/jslint-org/jslint
coverage-report javascript jslint zero-config zero-dependency
Last synced: about 1 month ago
JSON representation
JSLint, The JavaScript Code Quality and Coverage Tool
- Host: GitHub
- URL: https://github.com/jslint-org/jslint
- Owner: jslint-org
- License: unlicense
- Created: 2010-11-12T22:50:24.000Z (over 13 years ago)
- Default Branch: beta
- Last Pushed: 2024-03-28T07:17:59.000Z (2 months ago)
- Last Synced: 2024-04-27T06:50:36.537Z (about 1 month ago)
- Topics: coverage-report, javascript, jslint, zero-config, zero-dependency
- Language: JavaScript
- Homepage: https://www.jslint.com
- Size: 36.5 MB
- Stars: 3,597
- Watchers: 157
- Forks: 457
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Lists
- awesome-javascript - JSLint - High-standards, strict & opinionated code quality tool, aiming to keep only good parts of the language. (QA Tools / Runner)
- my-awesome-starred - jslint-org/jslint - JSLint, The JavaScript Code Quality and Coverage Tool (JavaScript)
- awesome-stars - jslint-org/jslint - JSLint, The JavaScript Code Quality and Coverage Tool (JavaScript)
- awesome - jslint - The JavaScript Code Quality Tool (JavaScript)
- awesome-stars - jslint-org/jslint - JSLint, The JavaScript Code Quality and Coverage Tool (JavaScript)
- awesome-stars - jslint-org/jslint - JSLint, The JavaScript Code Quality and Coverage Tool (JavaScript)
README
# [
](https://github.com/jslint-org/jslint) JSLint, The JavaScript Code Quality and Coverage Tool
Douglas Crockford
# Status
| Branch | [master
(v2023.10.24)](https://github.com/jslint-org/jslint/tree/master) | [beta
(Web Demo)](https://github.com/jslint-org/jslint/tree/beta) | [alpha
(Development)](https://github.com/jslint-org/jslint/tree/alpha) |
|--:|:--:|:--:|:--:|
| CI | [](https://github.com/jslint-org/jslint/actions?query=branch%3Amaster) | [](https://github.com/jslint-org/jslint/actions?query=branch%3Abeta) | [](https://github.com/jslint-org/jslint/actions?query=branch%3Aalpha) |
| Coverage | [](https://jslint-org.github.io/jslint/branch-master/.artifact/coverage/index.html) | [](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage/index.html) | [](https://jslint-org.github.io/jslint/branch-alpha/.artifact/coverage/index.html) |
| Demo | [](https://jslint-org.github.io/jslint/branch-master/index.html) | [](https://jslint-org.github.io/jslint/branch-beta/index.html) | [](https://jslint-org.github.io/jslint/branch-alpha/index.html) |
| Artifacts | [
](https://github.com/jslint-org/jslint/tree/gh-pages/branch-master/.artifact) | [](https://github.com/jslint-org/jslint/tree/gh-pages/branch-beta/.artifact) | [](https://github.com/jslint-org/jslint/tree/gh-pages/branch-alpha/.artifact) |
# Table of Contents
1. [Web Demo](#web-demo)
2. [Web Demo Archived](#web-demo-archived)
3. [Quickstart Install](#quickstart-install)
- [To install, just download and save https://www.jslint.com/jslint.mjs to file:](#to-install-just-download-and-save-httpswwwjslintcomjslintmjs-to-file)
- [To run `jslint.mjs` in shell:](#to-run-jslintmjs-in-shell)
- [To import `jslint.mjs` in ES Module environment:](#to-import-jslintmjs-in-es-module-environment)
- [To import `jslint.mjs` in CommonJS environment:](#to-import-jslintmjs-in-commonjs-environment)
- [To JSLint entire directory in shell:](#to-jslint-entire-directory-in-shell)
4. [Quickstart JSLint Report](#quickstart-jslint-report)
- [To create a JSLint report in shell:](#to-create-a-jslint-report-in-shell)
- [To create a JSLint report in javascript:](#to-create-a-jslint-report-in-javascript)
5. [Quickstart V8 Coverage Report](#quickstart-v8-coverage-report)
- [To create V8 coverage report from Node.js / Npm program in shell:](#to-create-v8-coverage-report-from-nodejs--npm-program-in-shell)
- [To create V8 coverage report from Node.js / Npm program in javascript:](#to-create-v8-coverage-report-from-nodejs--npm-program-in-javascript)
6. [Quickstart JSLint in CodeMirror](#quickstart-jslint-in-codemirror)
7. [Quickstart JSLint in Vim](#quickstart-jslint-in-vim)
8. [Quickstart JSLint in VSCode](#quickstart-jslint-in-vscode)
9. [Documentation](#documentation)
- [API Doc](#api-doc)
- [Directive `/*jslint*/`](#directive-jslint)
- [`/*jslint beta*/`](#jslint-beta)
- [`/*jslint bitwise*/`](#jslint-bitwise)
- [`/*jslint browser*/`](#jslint-browser)
- [`/*jslint convert*/`](#jslint-convert)
- [`/*jslint couch*/`](#jslint-couch)
- [`/*jslint devel*/`](#jslint-devel)
- [`/*jslint eval*/`](#jslint-eval)
- [`/*jslint fart*/`](#jslint-fart)
- [`/*jslint for*/`](#jslint-for)
- [`/*jslint getset*/`](#jslint-getset)
- [`/*jslint indent2*/`](#jslint-indent2)
- [`/*jslint long*/`](#jslint-long)
- [`/*jslint node*/`](#jslint-node)
- [`/*jslint nomen*/`](#jslint-nomen)
- [`/*jslint single*/`](#jslint-single)
- [`/*jslint subscript*/`](#jslint-subscript)
- [`/*jslint this*/`](#jslint-this)
- [`/*jslint trace*/`](#jslint-trace)
- [`/*jslint unordered*/`](#jslint-unordered)
- [`/*jslint white*/`](#jslint-white)
- [Directive `/*global*/`](#directive-global)
- [Directive `/*property*/`](#directive-property)
- [Directive `/*jslint-disable*/.../*jslint-enable*/`](#directive-jslint-disablejslint-enable)
- [Directive `//jslint-ignore-line`](#directive-jslint-ignore-line)
10. [Package Listing](#package-listing)
11. [Changelog](#changelog)
12. [License](#license)
13. [Devops Instruction](#devops-instruction)
- [branch-master commit](#branch-master-commit)
- [branch-master publish](#branch-master-publish)
- [pull-request merge](#pull-request-merge)
- [vscode-jslint publish](#vscode-jslint-publish)
# Web Demo
- https://www.jslint.com
[](https://jslint-org.github.io/jslint/index.html)
# Web Demo Archived
- [Web Demo 2020](https://www.jslint.com/branch-v2020.11.6/index.html)
- [Web Demo 2014 (ES5 only)](https://www.jslint.com/branch-v2014.7.8/jslint.html)
- [Web Demo 2013 (ES5, CSS, HTML)](https://www.jslint.com/branch-v2013.3.13/jslint.html)
# Quickstart Install
### To install, just download and save https://www.jslint.com/jslint.mjs to file:
```shell
#!/bin/sh
curl -L https://www.jslint.com/jslint.mjs > jslint.mjs
```
- shell output
### To run `jslint.mjs` in shell:
```shell
#!/bin/sh
printf "console.log('hello world');\n" > hello.js
node jslint.mjs hello.js
```
- shell output
### To import `jslint.mjs` in ES Module environment:
```shell
#!/bin/sh
node --input-type=module --eval '
/*jslint devel*/
// Import JSLint in ES Module environment.
import jslint from "./jslint.mjs";
let globals = ["caches", "indexedDb"];
let options = {browser: true};
let result;
let source = "console.log(\u0027hello world\u0027);\n";
// JSLint and print .
result = jslint.jslint(source, options, globals);
result.warnings.forEach(function ({
formatted_message
}) {
console.error(formatted_message);
});
'
```
- shell output
### To import `jslint.mjs` in CommonJS environment:
```shell
#!/bin/sh
node --eval '
/*jslint devel*/
(async function () {
let globals = ["caches", "indexedDb"];
let jslint;
let options = {browser: true};
let result;
let source = "console.log(\u0027hello world\u0027);\n";
// Import JSLint in CommonJS environment.
jslint = await import("./jslint.mjs");
jslint = jslint.default;
// JSLint and print .
result = jslint.jslint(source, options, globals);
result.warnings.forEach(function ({
formatted_message
}) {
console.error(formatted_message);
});
}());
'
```
- shell output
### To JSLint entire directory in shell:
```shell
#!/bin/sh
# JSLint directory '.'
node jslint.mjs .
```
- shell output
# Quickstart JSLint Report
### To create a JSLint report in shell:
```shell
#!/bin/sh
printf "function foo() {console.log('hello world');}\n" > hello.js
# Create JSLint report from file 'hello.js' in shell.
node jslint.mjs \
jslint_report=.artifact/jslint_report_hello.html \
hello.js
```
- shell output
- screenshot file [.artifact/jslint_report_hello.html](https://jslint-org.github.io/jslint/branch-beta/.artifact/jslint_report_hello.html)
[](https://jslint-org.github.io/jslint/branch-beta/.artifact/jslint_report_hello.html)
### To create a JSLint report in javascript:
```shell
#!/bin/sh
node --input-type=module --eval '
/*jslint devel*/
import jslint from "./jslint.mjs";
import fs from "fs";
(async function () {
let result;
let source = "function foo() {console.log(\u0027hello world\u0027);}\n";
// Create JSLint report from in javascript.
result = jslint.jslint(source);
result = jslint.jslint_report(result);
result = `\n${result}\n`;
await fs.promises.mkdir(".artifact/", {recursive: true});
await fs.promises.writeFile(".artifact/jslint_report_hello.html", result);
console.error("wrote file .artifact/jslint_report_hello.html");
}());
'
```
- shell output
- screenshot file [.artifact/jslint_report_hello.html](https://jslint-org.github.io/jslint/branch-beta/.artifact/jslint_report_hello.html)
[](https://jslint-org.github.io/jslint/branch-beta/.artifact/jslint_report_hello.html)
# Quickstart V8 Coverage Report
### To create V8 coverage report from Node.js / Npm program in shell:
```shell
#!/bin/sh
git clone https://github.com/tryghost/node-sqlite3 node-sqlite3-sh \
--branch=v5.0.11 \
--depth=1 \
--single-branch
cd node-sqlite3-sh
npm install
# Create V8 coverage report from program `npm run test` in shell.
node ../jslint.mjs \
v8_coverage_report=../.artifact/coverage_sqlite3_sh/ \
--exclude=tes?/ \
--exclude=tes[!0-9A-Z_a-z-]/ \
--exclude=tes[0-9A-Z_a-z-]/ \
--exclude=tes[^0-9A-Z_a-z-]/ \
--exclude=test/**/*.js \
--exclude=test/suppor*/*elper.js \
--exclude=test/suppor?/?elper.js \
--exclude=test/support/helper.js \
--include=**/*.cjs \
--include=**/*.js \
--include=**/*.mjs \
--include=li*/*.js \
--include=li?/*.js \
--include=lib/ \
--include=lib/**/*.js \
--include=lib/*.js \
--include=lib/sqlite3.js \
npm run test
```
- shell output
- screenshot file [.artifact/coverage_sqlite3_sh/index.html](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_sh/index.html)
[](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_sh/index.html)
- screenshot file [.artifact/coverage_sqlite3_sh/lib/sqlite3.js.html](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_sh/lib/sqlite3.js.html)
[](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_sh/lib/sqlite3.js.html)
### To create V8 coverage report from Node.js / Npm program in javascript:
```shell
#!/bin/sh
git clone https://github.com/tryghost/node-sqlite3 node-sqlite3-js \
--branch=v5.0.11 \
--depth=1 \
--single-branch
cd node-sqlite3-js
npm install
node --input-type=module --eval '
/*jslint node*/
import jslint from "../jslint.mjs";
(async function () {
// Create V8 coverage report from program `npm run test` in javascript.
await jslint.v8CoverageReportCreate({
coverageDir: "../.artifact/coverage_sqlite3_js/",
processArgv: [
"--exclude=tes?/",
"--exclude=tes[!0-9A-Z_a-z-]/",
"--exclude=tes[0-9A-Z_a-z-]/",
"--exclude=tes[^0-9A-Z_a-z-]/",
"--exclude=test/**/*.js",
"--exclude=test/suppor*/*elper.js",
"--exclude=test/suppor?/?elper.js",
"--exclude=test/support/helper.js",
"--include=**/*.cjs",
"--include=**/*.js",
"--include=**/*.mjs",
"--include=li*/*.js",
"--include=li?/*.js",
"--include=lib/",
"--include=lib/**/*.js",
"--include=lib/*.js",
"--include=lib/sqlite3.js",
"npm", "run", "test"
]
});
}());
'
```
- shell output
- screenshot file [.artifact/coverage_sqlite3_js/index.html](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_js/index.html)
[](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_js/index.html)
- screenshot file [.artifact/coverage_sqlite3_js/lib/sqlite3.js.html](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_js/lib/sqlite3.js.html)
[](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage_sqlite3_js/lib/sqlite3.js.html)
# Quickstart JSLint in CodeMirror
1. Download and save [`jslint.mjs`](https://www.jslint.com/jslint.mjs), [`jslint_wrapper_codemirror.js`](https://www.jslint.com/jslint_wrapper_codemirror.js) to file.
2. Edit, save, and serve example html-file below:
```html
CodeMirror: JSLint Demo
body {
background: #bbb;
color: #333;
font-family: sans-serif;
margin: 20px;
}
.JSLINT_.JSLINT_REPORT_ {
margin-top: 20px;
}
#editor1 {
height: 300px;
width: 100%;
}
CodeMirror: JSLint Demo
This demo will auto-lint the code below, and auto-generate a report as you type.
console.log('hello world');
window.addEventListener("load", function () {
let editor = window.CodeMirror.fromTextArea(document.getElementById(
"editor1"
), {
gutters: [
"CodeMirror-lint-markers"
],
indentUnit: 4,
lineNumbers: true,
lint: {
lintOnChange: true, // Enable auto-lint.
options: {
// browser: true,
// node: true
globals: [
// "caches",
// "indexedDb"
]
}
},
mode: "javascript"
});
// Initialize event-handling before linter is run.
editor.on("lintJslintBefore", function (/* options */) {
// options.browser = true;
// options.node = true;
// options.globals = [
// "caches",
// "indexedDb"
// ];
return;
});
// Initialize event-handling after linter is run.
editor.on("lintJslintAfter", function (options) {
// Generate jslint-report from options.result.
document.querySelector(
".JSLINT_REPORT_"
).innerHTML = window.jslint.jslint_report(options.result);
});
// Manually trigger linter.
editor.performLint();
});
```
3. Live example at https://www.jslint.com/jslint_wrapper_codemirror.html
[](https://jslint-org.github.io/jslint/jslint_wrapper_codemirror.html)
# Quickstart JSLint in Vim
1. Download and save [`jslint.mjs`](https://www.jslint.com/jslint.mjs), [`jslint_wrapper_vim.vim`](https://www.jslint.com/jslint_wrapper_vim.vim) to directory `~/.vim/`
2. Add vim-command `:source ~/.vim/jslint_wrapper_vim.vim` to file `~/.vimrc`
3. Vim can now jslint files (via nodejs):
- with vim-command `:SaveAndJslint`
- with vim-key-combo ` `
- screenshot
[](https://www.jslint.com/jslint_wrapper_vim.vim)
# Quickstart JSLint in VSCode
1. In VSCode, search and install extension [`vscode-jslint`](https://marketplace.visualstudio.com/items?itemName=jslint.vscode-jslint)
2. In VSCode, while editing a javascript file:
- right-click context-menu and select `[JSLint - Lint File]`
- or use key-binding `[Ctrl + Shift + J], [L]`
- or use key-binding `[ Cmd + Shift + J], [L]` for Mac
- screenshot
[](https://marketplace.visualstudio.com/items?itemName=jslint.vscode-jslint)
# Documentation
- [jslint.mjs](jslint.mjs) contains the jslint function. It parses and analyzes a source file, returning an object with information about the file. It can also take an object that sets options.
- [index.html](index.html) runs the jslint.mjs function in a web page.
JSLint can be run anywhere that JavaScript (or Java) can run.
The place to express yourself in programming is in the quality of your ideas and
the efficiency of their execution. The role of style in programming is the same
as in literature: It makes for better reading. A great writer doesn't express
herself by putting the spaces before her commas instead of after, or by putting
extra spaces inside her parentheses. A great writer will slavishly conform to
some rules of style, and that in no way constrains her power to express herself
creatively. See for example William Strunk's The Elements of Style
[https://www.crockford.com/style.html].
This applies to programming as well. Conforming to a consistent style improves
readability, and frees you to express yourself in ways that matter. JSLint here
plays the part of a stern but benevolent editor, helping you to get the style
right so that you can focus your creative energy where it is most needed.
### API Doc
- https://www.jslint.com/apidoc.html
[](https://www.jslint.com/apidoc.html)
### Directive `/*jslint*/`
##### `/*jslint beta*/`
```js
/*jslint beta*/
// Enable experimental warnings.
// Warn if global variables are redefined.
// Warn if const / let statements are not declared at top of function or
// script, similar to var statements.
// Warn if const / let / var statements are not declared in ascii-order.
// Warn if named-functions are not declared in ascii-order.
// Warn if cases in switch-statements are not in ascii-order.
```
##### `/*jslint bitwise*/`
```js
/*jslint bitwise*/
// Allow bitwise operator.
let foo = 0 | 1;
```
##### `/*jslint browser*/`
```js
/*jslint browser*/
// Assume browser environment.
localStorage.getItem("foo");
```
##### `/*jslint convert*/`
```js
/*jslint convert*/
// Allow conversion operator.
let foo = new Date() + "";
let bar = !!0;
```
##### `/*jslint couch*/`
```js
/*jslint couch*/
// Assume CouchDb environment.
registerType("text-json", "text/json");
```
##### `/*jslint devel*/`
```js
/*jslint devel*/
// Allow console.log() and friends.
console.log("hello");
```
##### `/*jslint eval*/`
```js
/*jslint eval*/
// Allow eval().
eval("1");
```
##### `/*jslint fart*/`
```js
/*jslint fart*/
// Allow complex fat-arrow.
let foo = async ({bar, baz}) => {
return await bar(baz);
};
```
##### `/*jslint for*/`
```js
/*jslint for*/
// Allow for-loop.
function foo() {
let ii;
for (ii = 0; ii < 10; ii += 1) {
foo();
}
}
```
##### `/*jslint getset*/`
```js
/*jslint getset, this, devel*/
// Allow get() and set().
let foo = {
bar: 0,
get getBar() {
return this.bar;
},
set setBar(value) {
this.bar = value;
}
};
console.log(foo.getBar); // 0
foo.setBar = 1;
console.log(foo.getBar); // 1
```
##### `/*jslint indent2*/`
```js
/*jslint indent2*/
// Use 2-space indent.
function foo() {
return;
}
```
##### `/*jslint long*/`
```js
/*jslint long*/
// Allow long lines.
let foo = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
```
##### `/*jslint node*/`
```js
/*jslint node*/
// Assume Node.js environment.
require("fs");
```
##### `/*jslint nomen*/`
```js
/*jslint nomen*/
// Allow weird property name.
let foo = {};
foo._bar = 1;
```
##### `/*jslint single*/`
```js
/*jslint single*/
// Allow single-quote strings.
let foo = '';
```
##### `/*jslint subscript*/`
```js
/*jslint subscript*/
// Allow identifiers in subscript-notation.
let foo = {};
foo["bar"] = 1;
```
##### `/*jslint this*/`
```js
/*jslint this*/
// Allow 'this'.
function foo() {
return this;
}
```
##### `/*jslint trace*/`
```js
/*jslint trace*/
// Include jslint stack-trace in warnings.
console.log('hello world');
/*
1. Undeclared 'console'.
console.log('hello world');
Error
at warn_at (...)
at warn (...)
at lookup (...)
at pre_v (...)
at jslint.mjs
2. Use double quotes, not single quotes.
console.log(...);
Error
at warn_at (...)
at lex_string (...)
at lex_token (...)
at jslint_phase2_lex (...)
at Function.jslint (...)
at jslint.mjs
*/
```
##### `/*jslint unordered*/`
```js
/*jslint unordered*/
// Allow unordered cases, params, properties, variables, and exports.
let foo = {bb: 1, aa: 0};
function bar({
bb = 1,
aa = 0
}) {
return aa + bb;
}
export {
foo,
bar
};
```
##### `/*jslint white*/`
```js
/*jslint white*/
// Allow messy whitespace.
let foo = 1; let bar = 2;
```
### Directive `/*global*/`
```js
/*global foo, bar*/
// Declare global variables foo, bar.
foo();
bar();
```
### Directive `/*property*/`
```js
/*property foo, bar*/
// Restrict property-access to only .foo, .bar.
let aa = {bar: 1, foo: 2};
```
### Directive `/*jslint-disable*/.../*jslint-enable*/`
```js
/*jslint-disable*/
JSLint will ignore and treat this region as blank-lines.
Syntax error.
/*jslint-enable*/
```
### Directive `//jslint-ignore-line`
```js
// JSLint will ignore non-fatal warnings at given line.
eval("1"); //jslint-ignore-line
```
# Package Listing
# Changelog
- [Full CHANGELOG.md](CHANGELOG.md)
# License
- JSLint is under [Unlicense License](LICENSE).
- CodeMirror editor is under [MIT License](https://github.com/codemirror/codemirror5/blob/d0e3b2e727c41aa4fd89fbad0adfb3815339174c/LICENSE).
- Function `v8CoverageListMerge` is derived from [MIT Licensed v8-coverage](https://github.com/demurgos/v8-coverage/blob/73446087dc38f61b09832c9867122a23f8577099/ts/LICENSE.md).
# Devops Instruction
### branch-master commit
- $ `shGitSquashPop '# v20yy.mm.dd\n'`
- verify correct-year `20yy`
- $ `git push origin alpha:branch-v20yy.mm.dd`
- $ `git push upstream alpha -f`
- verify ci-success for upstream-branch-alpha
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
- goto https://github.com/kaizhu256/jslint/pulls
- click `New pull request`
- click `base repository: jslint-org/jslint base:beta`
- click `head repository: kaizhu256/jslint compare:branch-v20yy.mm.dd`
- verify `commit into jslint-org:beta`
- click `Create pull request`
- verify ci-success for pull-request
- https://github.com/jslint-org/jslint/actions/workflows/on_pull_request.yml
- click `Rebase and merge`
- verify ci-success for upstream-branch-beta
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
```shell
git fetch upstream beta
git diff alpha..upstream/beta
# verify no diff between alpha..upstream/beta
git reset upstream/beta
git push origin alpha -f
git push origin alpha:beta
shMyciUpdate
git push upstream alpha -f
```
- verify ci-success for origin-branch-alpha
- https://github.com/kaizhu256/jslint/actions/workflows/ci.yml
- verify ci-success for upstream-branch-alpha
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
- click `Delete branch`
```shell
git push origin beta:master
git push upstream beta:master
```
- verify ci-success for origin-branch-master
- https://github.com/kaizhu256/jslint/actions/workflows/ci.yml
- verify ci-success for upstream-branch-master
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
### branch-master publish
- $ `git push upstream beta:master`
- verify ci-success for upstream-branch-master
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
- goto https://github.com/jslint-org/jslint/releases/new
- input tag `v20yy.mm.dd`
- click `Create new tag: v20yy.mm.dd on publish`
- verify correct-year `20yy`
- click `Target: master`
- input `Release title: v20yy.mm.dd - `
- copy-paste release notes from CHANGELOG.md
- click `Generate release notes`
- click `Set as the latest release`
- click `Preview` and review
- click `Publish release`
- verify ci-success for upstream-branch-publish
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
- verify email-notification `Successfully published @jslint-org/[email protected]`
### pull-request merge
- find highest issue-number at https://github.com/jslint-org/jslint/issues/, and add +1 to it for PR-xxx
- verify `commit into jslint-org:beta`
- click `Create pull request`
- verify ci-success for pull-request
- https://github.com/jslint-org/jslint/actions/workflows/on_pull_request.yml
- click `Rebase and merge`
- verify ci-success for upstream-branch-beta
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
```shell
git fetch upstream beta
git diff alpha..upstream/beta
# verify no diff between alpha..upstream/beta
git reset upstream/beta
git push origin alpha -f
git push origin alpha:beta
shMyciUpdate
git push upstream alpha -f
```
- verify ci-success for origin-branch-alpha
- https://github.com/kaizhu256/jslint/actions/workflows/ci.yml
- verify ci-success for upstream-branch-alpha
- https://github.com/jslint-org/jslint/actions/workflows/ci.yml
- click `Delete branch`
### vscode-jslint publish
- goto https://github.com/jslint-org/jslint/tree/gh-pages/branch-beta/.artifact/jslint_wrapper_vscode
- click `vscode-jslint-20yy.mm.dd.vsix`
- click `Download`
- goto https://marketplace.visualstudio.com/manage/publishers/jslint
- right-click `Update`
- drag-and-drop downloaded `vscode-jslint-20yy.mm.dd.vsix`
- click 'Upload'
- verify email-notification `[Succeeded] Extension publish on Visual Studio Marketplace - vscode-jslint`