[DOC] Downloadable PDF Developer Guides

Signed-off-by: Arya Soni <aryasoni98@gmail.com>

Author: aryasoni98

.github/workflows/generate-pdfs.yml

@@ -0,0 +1,74 @@
+name: Generate PDFs
+
+on:
+  workflow_dispatch:
+  schedule:
+    # Run weekly on Sundays at 2 AM UTC
+    - cron: "0 2 * * 0"
+  # Optional: Run after main branch updates (uncomment if desired)
+  # push:
+  #   branches:
+  #     - main
+
+jobs:
+  generate-pdfs:
+    if: github.repository == 'opensearch-project/documentation-website'
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4.5'
+          bundler-cache: true
+
+      - name: Build Jekyll site
+        env:
+          JEKYLL_ENV: production
+        run: |
+          bundle exec jekyll build --future
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Generate PDFs
+        run: |
+          npm run generate-pdfs
+
+      - name: List generated PDFs
+        run: |
+          echo "Generated PDFs:"
+          ls -lh pdfs/ || echo "No PDFs generated"
+
+      - name: Upload PDFs as artifacts
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: opensearch-documentation-pdfs
+          path: pdfs/*.pdf
+          retention-days: 30
+
+      # Optional: Create a GitHub release with PDFs
+      # Uncomment and configure if you want to automatically create releases
+      # - name: Create GitHub Release
+      #   if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+      #   uses: softprops/action-gh-release@v1
+      #   with:
+      #     files: pdfs/*.pdf
+      #     tag_name: pdfs-${{ github.run_number }}
+      #     name: Documentation PDFs
+      #     body: |
+      #       Automatically generated PDF documentation for OpenSearch.
+      #       Generated on ${{ github.run_id }}
+      #   env:
+      #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

.gitignore

@@ -9,3 +9,6 @@ Gemfile.lock
 .jekyll-cache
 .project
 vendor/bundle
+node_modules
+pdfs
+package-lock.json

DEVELOPER_GUIDE.md

@@ -300,3 +300,78 @@ cd spec-insert
 bundle exec rake generate_dry_run_report
 ```
 This will also generate a markdown (.md) file for each API with their rendered components in the `spec-insert/dry_run` folder. This allows you to preview the rendered components for all APIs without modifying the original documentation files. A report summarizing the errors found during the dry-run will be generated in the `spec-insert/dry_run_report.md` file.
+
+## PDF Generation
+
+The documentation website supports generating PDF versions of the developer guides and other documentation sections. This feature allows users to download complete documentation sets for offline use, easier searching, and integration with AI tools.
+
+### Generating PDFs Locally
+
+To generate PDFs locally:
+
+1. **Install Node.js dependencies:**
+   ```shell
+   npm install
+   ```
+
+2. **Build the Jekyll site:**
+   ```shell
+   bundle exec jekyll build
+   ```
+
+3. **Generate PDFs:**
+   ```shell
+   npm run generate-pdfs
+   ```
+
+   Or generate a PDF for a specific collection:
+   ```shell
+   npm run generate-pdfs -- --collection developer-documentation
+   ```
+
+The generated PDFs will be saved in the `pdfs/` directory.
+
+### PDF Generation Configuration
+
+PDF generation is configured in `pdf-config.json`. This file defines:
+- Which collections to convert to PDFs
+- PDF output settings (format, margins, headers, footers)
+- Base URL and output directory
+
+You can customize the configuration by editing `pdf-config.json`.
+
+### CI/CD Integration
+
+PDF generation runs automatically in CI/CD through the [generate-pdfs.yml](.github/workflows/generate-pdfs.yml) GitHub Actions workflow. This workflow:
+
+- Runs weekly on Sundays at 2 AM UTC
+- Can be triggered manually via `workflow_dispatch`
+- Builds the Jekyll site
+- Generates PDFs for all configured collections
+- Uploads PDFs as GitHub Actions artifacts
+
+The workflow runs separately from the main Jekyll build to avoid adding to build time.
+
+### Available PDFs
+
+The following documentation sections are available as PDFs (as configured in `pdf-config.json`):
+
+- OpenSearch Developer Guide
+- Getting Started Guide
+- API Reference
+- Install and Configure Guide
+- Cluster Tuning Guide
+- Security Guide
+- Query DSL Guide
+- Search Features Guide
+- Vector Search Guide
+- Machine Learning Guide
+
+### Copyright and Usage
+
+OpenSearch documentation is licensed under the Apache License 2.0, which allows you to:
+- Use the PDFs for personal or commercial purposes
+- Upload PDFs to AI tools (ChatGPT, NotebookLLM, etc.) for knowledge summarization
+- Share and distribute the PDFs
+
+Proper attribution should be maintained when using the documentation.