You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.md
+1-5Lines changed: 1 addition & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,5 @@
1
1
# Changelog
2
2
3
-
4
3
This changelog documents significant changes that caused a new version in the manual, or other related resources.
5
4
6
5
We don't create a version fork for every minor release, and try to make docs "append only" as much as possible. Usually when we introduce a new feature we add a `since 9.0` annotation to a specific section, and be done with it.
@@ -13,8 +12,7 @@ Here are the notes on major changes we did, and how the version corresponds to s
13
12
14
13
### latest
15
14
16
-
- 9.1 related
17
-
-
15
+
-## 9.1 related
18
16
19
17
### v9.0 (v8.3 - v9.0)
20
18
@@ -34,5 +32,3 @@ Here are the notes on major changes we did, and how the version corresponds to s
34
32
### v8.0.0 (v6 - v8.3)
35
33
36
34
- Docs with Reason / OCaml syntax before the new syntax
Copy file name to clipboardExpand all lines: _blogposts/2020-08-10-bucklescript-is-rebranding.mdx
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,13 +21,15 @@ We're pleased to announce that BuckleScript is getting a brand new name: **ReScr
21
21
## Community Situation
22
22
23
23
BuckleScript started with the idea that **JavaScript programmers deserved a great typed language with a fast and lean toolchain**. This idea took root and, over the years, we've gradually accomplished feats such as:
24
+
24
25
- a state of the art compiled JavaScript output that rivals hand-written JS,
25
26
- a fast & reliable toolchain much needed in front-end and Node development,
26
27
- various JS interop features that spawned an ecosystem of well typed libraries,
27
28
- a production-ready standard library,
28
29
-[and recently](/blog/bucklescript-8-1-new-syntax), a fresh syntax made by a major contributor of Reason's old syntax.
29
30
30
31
These developments have attracted many people into our community. But one bigger challenge persisted: newcomers dropped out at the sheer amount of extra incongruent tools and learning overhead from having to understand OCaml concepts, Reason concepts, and BuckleScript's concepts. Take, for example, what's required to make a React app using BuckleScript:
32
+
31
33
- Knowledge of React.
32
34
- Knowledge of JS.
33
35
- Knowledge of BuckleScript's specific bindings to React (that we've tried hard to keep to a minimum).
@@ -43,6 +45,7 @@ The adoption barrier is real, and it's about time we finally solve it.
43
45
## The Rebranding
44
46
45
47
Today, we'll start to truly unify the various BuckleScript-related projects under the ReScript umbrella. This includes:
48
+
46
49
- The compiler, build system and the new syntax unified under a single installation.
47
50
- Doubling down on editor tooling for ReScript usage.
48
51
- A single documentation site (this one), which unifies all the docs and greatly trims down on redundant and stale info.
Copy file name to clipboardExpand all lines: _blogposts/2020-08-28-new-rescript-logo.mdx
+17-8Lines changed: 17 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,35 +15,44 @@ ReScript is the evolution and fusion of Reason and BuckleScript. As we're a desi
15
15
16
16
Here it is!
17
17
18
-
19
-
<ImagewithShadow={false}src="/static/blog/rescript-launch/ReScript-1.jpg"caption="Comparison between the Reason, BuckleScript and ReScript logos"/>
20
-
18
+
<Image
19
+
withShadow={false}
20
+
src="/static/blog/rescript-launch/ReScript-1.jpg"
21
+
caption="Comparison between the Reason, BuckleScript and ReScript logos"
22
+
/>
21
23
22
24
The old Reason and BuckleScript logo had many limitations:
25
+
23
26
- The icons didn't really work well on round Social Media profile images (or round shapes at all).
24
27
- There's no guideline on how the logo works inverted, or on colored background.
25
28
- The large red rectangle makes it difficult to balance the logo with other elements.
26
29
- The buckle and belt were a bit too literal and did not convey much.
27
30
28
31
The new logo addresses all these and more:
29
32
30
-
<ImagewithShadow={false}src="/static/blog/rescript-launch/ReScript-2.jpg"caption="Logo comparison on social media"/>
33
+
<Image
34
+
withShadow={false}
35
+
src="/static/blog/rescript-launch/ReScript-2.jpg"
36
+
caption="Logo comparison on social media"
37
+
/>
31
38
32
39
## Creating Meaning Through Simple Shapes
33
40
34
41
A minimal logo design is achieved by putting aside all distractions while focusing on legibility, meaning and small details like clear lines, interesting perspective and depth.
35
42
36
-
37
-
<ImagewithShadow={false}src="/static/blog/rescript-launch/ReScript-4.jpg"caption="ReScript logo variations and usage examples"/>
38
-
43
+
<Image
44
+
withShadow={false}
45
+
src="/static/blog/rescript-launch/ReScript-4.jpg"
46
+
caption="ReScript logo variations and usage examples"
47
+
/>
39
48
40
49
**The letter "r"**, composed of two shapes, is inspired by Albers, a german-born American Bauhaus artist and typographer. An object should be simple, beautiful, functional and accessible for everyone - a statement which applies to ReScript's principles perfectly.
41
50
42
51
**I/O**: The rectangle and circle represent the input / output, recalling the digital nature of a program.
43
52
44
53
**The red app-shaped background** references the vibrant, playful applications our developers are empowered to create with ReScript.
45
54
46
-
**The Logotype**("rescript") complements the brand mark with its clean look and its embrace of technology while retaining a functional look.
55
+
**The Logotype** ("rescript") complements the brand mark with its clean look and its embrace of technology while retaining a functional look.
47
56
48
57
We'd like to position ReScript to be a community of product-first developers who care about the fit & finish of their work, while keeping an eye on the quality of their engineering. This interplay of design and engineering is a hard-to-achieve but beautifully worthwhile sweet spot that's frequently been missing in the programmer community; our vibrant logo is our renewed symbolic step toward this mission. Come along with us on our journey!
Copy file name to clipboardExpand all lines: _blogposts/2020-09-25-release-8-3-2.mdx
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -74,7 +74,7 @@ To get the build output, instead of communicating through IPC, we adopted a simp
74
74
This makes the editor integration build-system agnostic, it does not need talk to the build system directly.
75
75
76
76
It also makes our build tool work with other watchers including Facebook's [watchman](https://facebook.github.io/watchman/).
77
-
Watchman is a more scalable watcher tool for some specific platforms and less memory hungry, however, we still need a watchman-client to get the output of triggered job.
77
+
Watchman is a more scalable watcher tool for some specific platforms and less memory hungry, however, we still need a watchman-client to get the output of triggered job.
78
78
We write the output to `.compiler.log` per each build, allowing clients to read compiler diagnostics when they want.
79
79
80
80
## A better algorithm for removing stale outputs
@@ -90,8 +90,8 @@ We scan `lib/bs` directory and check some dangling `cm{i,t,j,ti}` files, if it d
90
90
the current build set, it is considered stale artifacts. If it is `cmt` file, it would trigger some hooks of `genType`, notably -cmt-rm.
91
91
92
92
- Based on previous build logs
93
-
We store previous compilation stats. If a file is in the previous compiler output, but no longer in the output of the new build, it is considered stale and can be removed.
94
-
it is considered stale output which can be removed.
93
+
We store previous compilation stats. If a file is in the previous compiler output, but no longer in the output of the new build, it is considered stale and can be removed.
94
+
it is considered stale output which can be removed.
95
95
96
96
In general, strategy two is more reliable and efficient.
97
97
@@ -100,11 +100,9 @@ In general, strategy two is more reliable and efficient.
100
100
101
101
However, strategy one is easier for tooling like `genType`. Not every tool has knowledge of the build system.
102
102
103
-
104
103
Sometimes a combination of both strategies is needed.
105
-
- When removing .cm* files, we use the first strategy.
106
-
- When removing generated javascript, we use strategy two,
107
-
108
104
105
+
- When removing .cm\* files, we use the first strategy.
106
+
- When removing generated javascript, we use strategy two,
0 commit comments