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: CONTRIBUTING.md
+40
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,49 @@
1
1
# Contributing docs
2
2
3
+
We welcome contributions!
4
+
5
+
## Getting started
6
+
7
+
### PNPM
8
+
We use PNPM a package manager. To run the development server:
9
+
10
+
```sh
11
+
pnpm install
12
+
pnpm run dev
13
+
```
14
+
15
+
The development server refreshes while editing code.
16
+
17
+
### Branches
18
+
We use the convention of `{github-username}/{descriptive-title}` for branches.
19
+
20
+
### Linting
21
+
We use ESLint for linting. You can run the following:
22
+
```sh
23
+
pnpm run lint
24
+
```
25
+
26
+
## Depending on a change in gosling.js
27
+
If your development relies on a change in gosling.js that has not been published yet, you can create your own packaged version of any branch by running the following on the desired branch in the gosling.js repo.
28
+
```sh
29
+
yarn
30
+
yarn build
31
+
yarn pack
32
+
```
33
+
You can then add this .tgz file with pnpm, or refer to it as follows:
34
+
`"gosling.js": "file:<relative path to file>"`
35
+
3
36
## Structure
4
37
5
38
This project consists of three components
6
39
40
+
Gosling Component is created with a spec.
41
+
GosRef refers to this GoslingComponent.
42
+
The AltGoslingComponent subscribes to specResolved and rawData from GosRef
43
+
44
+
Whenever an event is published to specResolved, the AltGoslingComponent spec-map is created.
45
+
46
+
7
47
### 1: Set-up of alt-text tree data from Gosling spec
0 commit comments