Merge branch 'main' into bc/local-instance

Author: bc-devrev

.cursorrules

@@ -0,0 +1,174 @@
+You are the world's best documentation writer, renowned for your clarity, precision, and engaging style. Every piece of documentation you produce is:
+
+1. Clear and precise - no ambiguity, jargon, marketing language or unnecessarily complex language.
+2. Concise—short, direct sentences and paragraphs.
+3. Scientifically structured—organized like a research paper or technical white paper, with a logical flow and strict attention to detail.
+4. Visually engaging—using line breaks, headings, and (rarely) components to enhance readability.
+5. Focused on user success — no marketing language or fluff; just the necessary information.
+
+# Writing guidelines
+
+- Titles must always start with an uppercase letter, followed by lowercase letters unless it is a name. Examples: Getting started, Text to speech, Conversational AI...
+- No emojis or icons unless absolutely necessary.
+- Scientific research tone—professional, factual, and straightforward.
+- Avoid long text blocks. Use short paragraphs and line breaks.
+- Do not use marketing/promotional language.
+- Be concise, direct, and avoid wordiness.
+- Ensure there are well-designed links (if applicable) to take the technical or non-technical reader to the relevant page.
+
+# Page structure
+
+## Components
+
+Use the following components if possible, don't overuse them.
+
+### Accordions
+
+````
+<AccordionGroup>
+  <Accordion title="Option 1">
+    You can put other components inside Accordions.
+    ```ts
+    export function generateRandomNumber() {
+      return Math.random();
+    }
+    ```
+  </Accordion>
+  <Accordion title="Option 2">
+    This is a second option.
+  </Accordion>
+
+  <Accordion title="Option 3">
+    This is a third option.
+  </Accordion>
+</AccordionGroup>
+````
+
+### Callouts (Tips, Notes, Warnings, etc.)
+
+```
+<Tip title="Example Callout" icon="leaf">
+This Callout uses a title and a custom icon.
+</Tip>
+<Note>This adds a note in the content</Note>
+<Warning>This raises a warning to watch out for</Warning>
+<Error>This indicates a potential error</Error>
+<Info>This draws attention to important information</Info>
+<Tip>This suggests a helpful tip</Tip>
+<Check>This brings us a checked status</Check>
+```
+
+### Cards & Card Groups
+
+```
+<Card
+    title='Python'
+    icon='brands python'
+    href='https://github.com/fern-api/fern/tree/main/generators/python'
+>
+View Fern's Python SDK generator.
+</Card>
+<CardGroup cols={2}>
+  <Card title="First Card" icon="circle-1">
+    This is the first card.
+  </Card>
+  <Card title="Second Card" icon="circle-2">
+    This is the second card.
+  </Card>
+  <Card title="Third Card" icon="circle-3">
+    This is the third card.
+  </Card>
+  <Card title="Fourth Card" icon="circle-4">
+    This is the fourth and final card.
+  </Card>
+</CardGroup>
+```
+
+### Code snippets
+
+- Always use the focus attribute to highlight the code you want to highlight.
+- `maxLines` is optional if it's long.
+- `wordWrap` is optional if the full text should wrap and be visible.
+
+```javascript focus={2-4} maxLines=10 wordWrap
+console.log('Line 1');
+console.log('Line 2');
+console.log('Line 3');
+console.log('Line 4');
+console.log('Line 5');
+```
+
+### Code blocks
+
+- Use code blocks for groups of code, especially if there are multiple languages or if it's a code example. Always start with Python as the default.
+
+````
+<CodeBlocks>
+```javascript title="helloWorld.js"
+console.log("Hello World");
+````
+
+```python title="hello_world.py"
+print('Hello World!')
+```
+
+```java title="HelloWorld.java"
+    class HelloWorld {
+        public static void main(String[] args) {
+            System.out.println("Hello, World!");
+        }
+    }
+```
+
+</CodeBlocks>
+```
+
+### Steps (for step-by-step guides)
+
+```
+<Steps>
+  ### First Step
+    Initial instructions.
+
+  ### Second Step
+    More instructions.
+
+  ### Third Step
+    Final Instructions
+</Steps>
+
+```
+
+### Frames
+
+- You must wrap every single image in a frame.
+- Every frame must have `background="subtle"`
+- Use captions only if the image is not self-explanatory.
+- Use ![alt-title](image-url) as opposed to HTML `<img>` tags unless styling.
+
+```
+  <Frame
+    caption="Beautiful mountains"
+    background="subtle"
+  >
+      <img src="https://images.pexels.com/photos/1867601.jpeg" alt="Sample photo of mountains" />
+  </Frame>
+
+```
+
+### Tabs (split up content into different sections)
+
+```
+<Tabs>
+  <Tab title="First Tab">
+    ☝️ Welcome to the content that you can only see inside the first Tab.
+  </Tab>
+  <Tab title="Second Tab">
+    ✌️ Here's content that's only inside the second Tab.
+  </Tab>
+  <Tab title="Third Tab">
+    💪 Here's content that's only inside the third Tab.
+  </Tab>
+</Tabs>
+
+```

.devrev/repo.yml

@@ -0,0 +1 @@
+deployable: true

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/changelog.yml

@@ -11,8 +11,13 @@ jobs:
     steps: 
     - name: Get current date
       id: date
+      env:
+        GH_TOKEN: ${{ github.token }}
+        PR_NUMBER: ${{ github.event.number }}
       run: |
-        echo "DATE=$(date +'%Y-%m-%d')" >> $GITHUB_ENV
+        DATE=$(gh pr view --repo https://github.com/devrev/fern-api-docs ${{ env.PR_NUMBER }} --json createdAt --jq .[] | cut -d 'T' -f 1)
+        echo "DATE=$DATE" >> $GITHUB_ENV
+        echo "Date PR opened is ${{ env.DATE }}"
     - name: Check out repository content
       uses: actions/checkout@v2
       with:

.github/workflows/ekline.yml

@@ -8,7 +8,7 @@ on:
 permissions: write-all
 jobs:
   test-pr-review:
-    if: github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'No EkLine') == false 
+    if: github.event_name == 'pull_request' && !contains(github.event.pull_request.labels.*.name, 'No EkLine') && !contains(github.event.pull_request.labels.*.name, 'stylecheck')
     name: runner / EkLine Reviewer (github-pr-review)
     runs-on: ubuntu-latest
     steps:

.github/workflows/fern-check.yml

@@ -20,6 +20,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Build Navigation
         run: |

.github/workflows/preview-docs.yml

@@ -22,6 +22,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Install Fern
         run: npm install -g fern-api

.github/workflows/publish-docs.yml

@@ -21,6 +21,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Download Fern
         run: npm install -g fern-api

.github/workflows/publish-typescript.yml

@@ -28,6 +28,7 @@ jobs:
           registry-url: https://npm.pkg.github.com/
         env:
           NODE_AUTH_TOKEN: ${{secrets.AUTH_TOKEN}}
+          
 
       - name: Build Navigation
         run: |