docs: adjust all docs references to new docs site

- workflow path exclusions
- gitattributes etc
- CONTRIBUTING information
- typedoc generation

.gitattributes

@@ -1,4 +1,4 @@
 *.xcodeproj binary
 *.xcworkspace binary
-docs-react-native/typedoc.json merge=theirs linguist-vendored
-docs-react-native/typedoc.min.json merge=theirs linguist-vendored
+docs/typedoc.json merge=theirs linguist-vendored
+docs/typedoc.min.json merge=theirs linguist-vendored

.github/workflows/tests_e2e_android.yml

@@ -4,13 +4,13 @@ on:
   workflow_dispatch:
   pull_request:
     paths-ignore:
-      - 'docs-react-native/**'
+      - 'docs/**'
       - '**/*.md'
   push:
     branches:
       - main
     paths-ignore:
-      - 'docs-react-native/**'
+      - 'docs/**'
       - '**/*.md'
 
 concurrency:

.github/workflows/tests_e2e_ios.yml

@@ -4,13 +4,13 @@ on:
   workflow_dispatch:
   pull_request:
     paths-ignore:
-      - 'docs-react-native/**'
+      - 'docs/**'
       - '**/*.md'
   push:
     branches:
       - main
     paths-ignore:
-      - 'docs-react-native/**'
+      - 'docs/**'
       - '**/*.md'
 
 concurrency:

.github/workflows/tests_jest.yml

@@ -4,13 +4,13 @@ on:
   workflow_dispatch:
   pull_request:
     paths-ignore:
-      - 'docs-react-native/**'
+      - 'docs/**'
       - '**/*.md'
   push:
     branches:
       - main
     paths-ignore:
-      - 'docs-react-native/**'
+      - 'docs/**'
       - '**/*.md'
 
 concurrency:

.github/workflows/tests_junit.yml

@@ -5,12 +5,13 @@ on:
   pull_request:
     paths:
       - '.github/workflows/*.yml'
+      - 'docs/**'
       - 'android/**'
   push:
     branches:
       - main
     paths-ignore:
-      - 'docs-react-native/**'
+      - 'docs/**'
       - '**/*.md'
 
 concurrency:

CONTRIBUTING.md

@@ -82,15 +82,36 @@ Maintainers with write access to the repo and the npm organization can publish n
 
 ### Release Checklist
 
+#### Automated Process
+
+**Note: release is fully automated now in `.github/workflows/publish.yml` and controlled by the `.releaserc` file**
+
+Simply navigate to the release publish workflow, and use the manual trigger to publish from main branch:
+
+1. https://github.com/invertase/notifee/actions/workflows/publish.yml
+
+Afterwards, you may verify that everything worked by checking the expected work products:
+
+1. Verify that there is a new github release: https://github.com/invertase/notifee/releases
+1. Verify that there is a new npmjs release (may take a moment to update): https://www.npmjs.com/package/@notifee/react-native?activeTab=versions
+1. Verify that the changelog is updated: https://docs.page/invertase/notifee/react-native/release-notes
+1. Verify that there is a new tag correctly created: https://github.com/invertase/notifee/tags
+1. Verify that there is a commit with that tag, with the updated release notes: https://github.com/invertase/notifee/commits/main/
+
+#### Manual Process
+
+If for some reason the automated process is not working, or you want to re-automate it using some other tools, these are the steps to take to correctly create and publish a release:
+
 1. Navigate to the React Native package: `cd packages/react-native`
-1. Update release notes [here](https://github.com/invertase/notifee/blob/main/docs-react-native/react-native/docs/release-notes.md)
+1. Update release notes [here](https://github.com/invertase/notifee/blob/main/docs/react-native/release-notes.mdx)
 1. Bump version: `npm version {major/minor/patch} --legacy-peer-deps`
-1. Publish to npm: `npm publish` (this generates a new core AAR)
+1. Publish to npm: `npm publish` (this generates a new core AAR, and requires a valid NPM login with permission to publish the Notifee package on npmjs.com)
 1. Commit those changes (after npm publish so new AAR files are committed)
 1. Tag the repo (current format is `@notifee/react-native@x.y.z`)
 1. Push the release notes / version / tag to the repo: `git push --tags`
 1. Create a release on the repo:
-    ```
+
+    ```bash
     export TAGNAME=`git tag --list|sort -r|head -1`
-    gh release create ${TAGNAME} --title "${TAGNAME}" --notes "[Release Notes](https://github.com/invertase/notifee/blob/main/docs-react-native/react-native/docs/release-notes.md)"
+    gh release create ${TAGNAME} --title "${TAGNAME}" --notes "[Release Notes](https://github.com/invertase/notifee/blob/main/docs/react-native/release-notes.mdx)"
     ```

package.json

@@ -36,7 +36,7 @@
     "lerna:bootstrap": "lerna bootstrap",
     "lerna:link": "lerna link && lerna exec -- yarn link",
     "lerna:clean": "lerna clean",
-    "gen:reference": "rimraf docs-react-native/typedoc.json docs-react-native/typedoc.min.json && node scripts/generate-typedoc.js",
+    "gen:reference": "rimraf docs/typedoc.json docs/typedoc.min.json && node scripts/generate-typedoc.js",
     "test:all": "yarn test:core:android && yarn tests_rn:test && yarn tests_rn:android:test && yarn tests_rn:ios:test",
     "test:core:android": "cd android && ./gradlew testDebugUnit",
     "tests_rn:packager": "cd tests_react_native && npx react-native start",

scripts/generate-typedoc.js

@@ -19,8 +19,8 @@ const { readFileSync, writeFileSync } = require('fs');
 const path = require('path');
 const { Application, TSConfigReader } = require('typedoc');
 
-const output = path.resolve(process.cwd(), 'docs-react-native', 'typedoc.json');
-const outputMin = path.resolve(process.cwd(), 'docs-react-native', 'typedoc.min.json');
+const output = path.resolve(process.cwd(), 'docs', 'typedoc.json');
+const outputMin = path.resolve(process.cwd(), 'docs', 'typedoc.min.json');
 
 const app = new Application();
 app.options.addReader(new TSConfigReader());

tests_react_native/metro.config.js

@@ -17,7 +17,7 @@ const config = {
     blocklist: exclusionList([
       /.*\/__fixtures__\/.*/,
       /.*\/template\/project\/node_modules\/react-native\/.*/,
-      new RegExp(`^${escape(resolve(rootDir, 'docs-react-native'))}\\/.*$`),
+      new RegExp(`^${escape(resolve(rootDir, 'docs'))}\\/.*$`),
       new RegExp(`^${escape(resolve(rootDir, 'tests_react_native/ios'))}\\/.*$`),
       new RegExp(`^${escape(resolve(rootDir, 'tests_react_native/e2e'))}\\/.*$`),
       new RegExp(`^${escape(resolve(rootDir, 'tests_react_native/android'))}\\/.*$`),