docs: Incorporate docs into monorepo (#8304)

<!-- Thanks for submitting a pull request! We appreciate you spending
the time to work on these changes. Please follow the template so that
the reviewers can easily understand what the code changes affect. -->

## Summary

More well-organized and sorted version of #8298 

This PR adds docs as a part of monorepo ecosystem, and makes them use
yarn v4.

To-do:

- [x] fix ymls
- [x] check if docs publish CI needs to be updated - probably not as it
worked locally, but needs to make sure react-native-reanimated is not
needed to be build beforehand
- [x] precommit
- [x] linting CIs

## Test plan

Run `yarn start` in both monorepos. **IMPORTANT!** Also run `yarn build
&& yarn serve` in reanimated - it won't work in worklets as worklet
documentation is done using some special under the table tricks to make
it possible for two docs to work in one monorepo. Take a look at CIs
changes, as well as new build path of docs.

Author: patrycjakalinska

.github/workflows/docs-reanimated-build-check.yml

@@ -32,18 +32,12 @@ jobs:
       - name: Install monorepo node dependencies
         working-directory: packages/react-native-reanimated
         run: yarn install
-      - name: Install Reanimated docs node dependencies
-        working-directory: ${{ env.REANIMATED_DOCS_DIR }}
-        run: yarn install
       - name: Lint check Reanimated docs
         working-directory: ${{ env.REANIMATED_DOCS_DIR }}
         run: yarn lint
       - name: Build Reanimated docs
         working-directory: ${{ env.REANIMATED_DOCS_DIR }}
         run: yarn build
-      - name: Install Worklets docs node dependencies
-        working-directory: ${{ env.WORKLETS_DOCS_DIR }}
-        run: yarn install
       - name: Lint check Worklets docs
         working-directory: ${{ env.WORKLETS_DOCS_DIR }}
         run: yarn lint

.github/workflows/docs-reanimated-publish.yml

@@ -27,13 +27,16 @@ jobs:
           git config --local user.email "[email protected]"
           && git config --local user.name "GitHub Action"
 
+      - name: Install monorepo node dependencies
+        run: yarn install
+
       - name: Build Reanimated docs
         working-directory: ${{ env.REANIMATED_DOCS_DIR }}
-        run: yarn && yarn build
+        run: yarn build
 
       - name: Build Worklets docs
         working-directory: ${{ env.WORKLETS_DOCS_DIR }}
-        run: yarn && yarn build
+        run: yarn build
 
       - name: Publish generated content to GitHub Pages
         uses: JamesIves/github-pages-deploy-action@releases/v3

.husky/pre-commit

@@ -9,10 +9,10 @@ check_and_lint_docs() {
   local docs_path="$2"
   local docs_name="$3"
 
-  print "Checking for changes in $docs_name docs..."
+  print "Checking for changes in $docs_name..."
   if echo "$staged_files" | grep "^$docs_path/" --silent; then
     print "Changes spotted. Running $docs_name docs lint..."
-    try cd "$docs_path" && yarn install --frozen-lockfile && yarn lint
+    try yarn workspace "$docs_name" lint
     print "Success."
   else
     print "No changes. Skipping $docs_name docs lint."
@@ -60,15 +60,10 @@ else
 fi
 
 # Linting docs
-REANIMATED_DOCS_PATH="packages/docs-reanimated"
-if [ -d "$REANIMATED_DOCS_PATH/node_modules" ]; then
-  check_and_lint_docs "$STAGED_FILES" "$REANIMATED_DOCS_PATH" "Reanimated"
-fi
-
-WORKLETS_DOCS_PATH="packages/docs-worklets"
-if [ -d "$WORKLETS_DOCS_PATH/node_modules" ]; then
-  check_and_lint_docs "$STAGED_FILES" "$WORKLETS_DOCS_PATH" "Worklets"
-fi
+for DOCS in docs-reanimated docs-worklets; do
+  DOCS_PATH="packages/$DOCS"
+  check_and_lint_docs "$STAGED_FILES" "$DOCS_PATH" "$DOCS"
+done
 
 # This automatically builds Reanimated Babel plugin JavaScript files if their
 # TypeScript counterparts were changed. It also adds the output file to the commit

package.json

@@ -8,6 +8,8 @@
       "packages/eslint-plugin-reanimated",
       "packages/react-native-worklets/plugin",
       "packages/react-native-worklets",
+      "packages/docs-reanimated",
+      "packages/docs-worklets",
       "apps/common-app",
       "apps/fabric-example",
       "apps/macos-example",