Skip to content

add notes about studio #1449

add notes about studio

add notes about studio #1449

name: Check all content (MDX) links
on:
pull_request:
permissions:
actions: read
checks: read
contents: read
issues: write
pull-requests: write
jobs:
check-for-absolute-urls:
name: "Check for dangerous urls"
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: check docs urls
id: absolute-urls
run: |
FILES_WITH_ABS_URLS=$(grep -Erl "https://prisma\.io/docs|https://www\.prisma\.io/docs" content) || echo "no absolute URLs found."
FILES_WITH_LOCAL_URLS=$(grep -Prl "(?<!!)\[.+\]\(\..+\)" content) || echo "no local URLs found."
OUTPUT="## Dangerous URL check"$'\n'
SUCCESS=false
if [ -n "${FILES_WITH_ABS_URLS}" ]; then # if there were matching files
OUTPUT+="### Absolute URLs"$'\n'
OUTPUT+="The following files have absolute URLs to prisma.io/docs. Please replace them with relative URLs."$'\n'
OUTPUT+="Example: https://www.prisma.io/docs/getting-started/quickstart -> /getting-started/quickstart"$'\n'
for line in ${FILES_WITH_ABS_URLS}
do
OUTPUT+="${line}"$'\n'
done
OUTPUT+=""$'\n'
else
# no matching files
OUTPUT+="No absolute URLs to prisma.io/docs found."$'\n'
SUCCESS=true
fi
if [ -n "${FILES_WITH_LOCAL_URLS}" ]; then
OUTPUT+="### Local URLs"$'\n'
OUTPUT+="The following files have local URLs. Please remove any leading dots."$'\n'
OUTPUT+="Example: ./getting-started/quickstart -> /getting-started/quickstart"$'\n'
for line in ${FILES_WITH_LOCAL_URLS}
do
OUTPUT+="${line}"$'\n'
done
else
OUTPUT+="No local URLs found."$'\n'
SUCCESS=true
fi
# check success
if [ -n "${FILES_WITH_ABS_URLS}" ] || [ -n "${FILES_WITH_LOCAL_URLS}" ]; then
SUCCESS=false
else
SUCCESS=true
fi
# https://github.com/orgs/community/discussions/26288#discussioncomment-3876281
{
echo 'body<<EOF'
echo "$OUTPUT"
echo EOF
} >> "$GITHUB_OUTPUT"
echo "success=${SUCCESS}" >> "$GITHUB_OUTPUT"
- uses: ./.github/actions/create-or-update-comment
with:
pull-request: ${{ github.event.pull_request.number }}
body: ${{ steps.absolute-urls.outputs.body }}
body-includes: absolute URLs
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: report success
run: |
if ${{ steps.absolute-urls.outputs.success }}; then
exit 0;
else
exit 1;
fi
check-for-dead-links:
name: Check links
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 18
- name: Install deps
run: npm install
# - name: Install remark presets
# run: npm install remark-lint-no-dead-urls remark-custom-header-id
# - name: Check external links (remark-cli)
# env:
# BRANCH_NAME: ${{ github.head_ref || github.ref_name }}
# run: |
# npx remark-cli . -qf -e=md,mdx --use remark-mdx --use remark-custom-header-id --use remark-frontmatter --use remark-gfm \
# --use "remark-lint-no-dead-urls=skipLocalhost:true,skipUrlPatterns:[\
# 'https://console.prisma.io',\
# 'https://dash.cloudflare.com',\
# 'https://www.cloudflare.com',\
# 'https://www.mysql.com',\
# 'https://dev.mysql.com',\
# 'https://azure.microsoft.com',\
# 'https://pris.ly/*',\
# 'https://typeorm.io',\
# 'https://github.com',\
# 'mailto*'\
# ]"
- name: Check internal links (docusaurus build)
env:
DOCUSAURUS_POST_HOG_KEY: ${{ secrets.DOCUSAURUS_POST_HOG_KEY }}
run: npm run clean && npm run build
check-for-redirects:
name: Check for needed redirects
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Create suggested redirects
id: redirects
run: |
bash .github/workflows/scripts/generate-redirects.sh
- uses: ./.github/actions/create-or-update-comment
with:
pull-request: ${{ github.event.pull_request.number }}
body: ${{ steps.redirects.outputs.body }}
body-includes: following redirects
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}