-
Notifications
You must be signed in to change notification settings - Fork 3
/
faq.html
109 lines (95 loc) · 3.98 KB
/
faq.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Shift</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="">
<meta name="author" content="">
<link rel="icon" href="favicon.ico">
<link href="css/bootstrap.min.css" rel="stylesheet">
<link href="css/bootstrap-responsive.min.css" rel="stylesheet">
<link href="css/css.css" rel="stylesheet">
<link href="css/nav.css" rel="stylesheet">
</head>
<body>
<div class="container-narrow">
<div class="content">
<ul class="nav nav-pills pull-right">
<li><a href="index.html">Home</a></li>
<li class="dropdown">
<a href="#" onclick="return false;">Family <span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="parser.html">Shift Parser</a></li>
<li><a href="codegen.html">Shift Code Generator</a></li>
<li><a href="scope.html">Shift Scope Analyser</a></li>
<li><a href="reducer.html">Shift Reducer</a></li>
<li><a href="fuzzer.html">Shift Fuzzer</a></li>
<li><a href="validator.html">Shift Validator</a></li>
<li><a href="estree-converter.html">Shift-ESTree Converter</a></li>
</ul>
</li>
<li><a target="_blank" href="https://github.com/shapesecurity/shift-spec">Spec</a></li>
<li><a target="_blank" href="https://github.com/shapesecurity?utf8=%E2%9C%93&query=shift">Github</a></li>
</ul>
<div class="jumbotron">
<h1><span class="shift">Shift</span> FAQ</h1>
</div>
<hr />
<h3>How will future ECMAScript versions be supported?</h3>
<section>
<p>
A new version of the Shift specification will be released shortly
after the release of the next ECMAScript document. Shift ASTs that
conform to earlier versions of the Shift specification may not
conform to the most recent version of the Shift specification.
</p>
</section>
<h3>Is the Shift AST available in non-ECMAScript environments?</h3>
<section>
<p>
Nothing about the Shift AST specification requires implementations to
be written in ECMAScript. The ECMAScript and Java implementations of
many tools based on the Shift AST specification are maintained by
Shape Security, with occasional contributions from the community.
Shift-based tools have been created for Haskell and Go.
</p>
</section>
<h3>How should I contribute to the Shift projects?</h3>
<section>
<p>
To contribute to one of the ECMAScript implementations, please
follow these steps.
</p>
<ul>
<li>
Open a Github issue with a description of your desired change.
If one exists already, leave a message stating that you are
working on it with the date you expect it to be complete.
<li>
Fork the repo, and clone the forked repo.
<li>
Install dependencies with <code class="sh">npm install</code>.
<li>
Build and test in your environment with
<code class="sh">npm run build && npm test</code>.
<li>
Create a feature branch. Make your changes. Add tests.
<li>
Build and test in your environment with
<code class="sh">npm run build && npm test</code>.
<li>
Make a commit that includes the text "fixes #<em>XX</em>" where
<em>XX</em> is the Github issue.
<li>
Open a Pull Request on Github.
</ul>
</section>
</div>
<hr />
<div class="footer">
<p>© Shape Security, Inc.</p>
</div>
</div>
</body>
</html>