ARROW-14739: [JS] Ensure docs point to right source

Closes #11728 from domoritz/dom/docs-build-remote

Lead-authored-by: Dominik Moritz <domoritz@gmail.com>
Co-authored-by: Sutou Kouhei <kou@cozmixng.org>
Signed-off-by: Sutou Kouhei <kou@clear-code.com>

ci/scripts/js_build.sh

@@ -30,7 +30,16 @@ yarn lint:ci
 yarn build
 
 if [ "${with_docs}" == "true" ]; then
-  yarn doc
+  if [ "$(git config --get remote.origin.url)" == "https://github.com/apache/arrow.git" ]; then
+    yarn doc
+  elif [ "$(git config --get remote.upstream.url)" == "https://github.com/apache/arrow.git" ]; then
+    yarn doc --gitRemote upstream
+  elif [ "$(git config --get remote.apache.url)" == "git@github.com:apache/arrow.git" ]; then
+    yarn doc --gitRemote apache
+  else
+    echo "Failed to build docs because the remote is not set correctly. Please set the origin or upstream remote to https://github.com/apache/arrow.git or the apache remote to git@github.com:apache/arrow.git."
+    exit 0
+  fi
 fi
 
 popd

dev/tasks/docker-tests/azure.linux.yml

@@ -43,6 +43,7 @@ jobs:
       git -C arrow fetch -t {{ arrow.remote }} {{ arrow.branch }}
       git -C arrow checkout FETCH_HEAD
       git -C arrow submodule update --init --recursive
+      git -C arrow remote add upstream https://github.com/apache/arrow.git
     displayName: Clone arrow
 
   - script: pip install -e arrow/dev/archery[docker]

js/DEVELOP.md

@@ -70,6 +70,10 @@ To run tests directly on the sources without bundling, use the `src` target (e.g
 
 Uses [lerna](https://github.com/lerna/lerna) to publish each build target to npm with [conventional](https://conventionalcommits.org/) [changelogs](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-cli).
 
+* `yarn doc`
+
+Compiles the documentation with [Typedoc](https://typedoc.org/). Use `yarn doc --watch` to automatically rebuild when the docs change.
+
 # Running the Performance Benchmarks
 
 You can run the benchmarks with `yarn perf`. To print the results to stderr as JSON, add the `--json` flag (e.g. `yarn perf --json 2> perf.json`).