[Docs] Add initial docs pages version (#1765)

Ticket: CVS-158840

Preview: https://yatarkan.github.io/openvino.genai

---------

Co-authored-by: Andrei Kochin <andrei.kochin@intel.com>

Author: yatarkan

.github/workflows/deploy_gh_pages.yml

@@ -0,0 +1,56 @@
+name: Deploy Docs to GitHub Pages
+
+on:
+  workflow_dispatch:
+
+concurrency:
+  group: 'pages'
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  build_assets:
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
+        with:
+          lfs: true
+
+      - name: Setup Node.js
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4.0.2
+        with:
+          node-version: 20
+
+      - name: Install Node.js dependencies
+        working-directory: ./site
+        shell: bash
+        run: npm ci
+
+      - name: Build static for GitHub Pages
+        working-directory: ./site
+        shell: bash
+        run: npm run build
+
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
+        with:
+          path: ./site/build
+
+  deploy_github_pages:
+    runs-on: ubuntu-22.04
+    needs: build_assets
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5

site/.editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+
+root = false
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+max_line_length = 100
+trim_trailing_whitespace = true
+
+[*.md]
+insert_final_newline = true
+trim_trailing_whitespace = false

site/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

site/.prettierignore

@@ -0,0 +1,12 @@
+dist
+node_modules
+.yarn
+build
+coverage
+.docusaurus
+.idea
+
+.svg
+*.svg
+
+*.mdx

site/.prettierrc

@@ -0,0 +1,10 @@
+{
+  "printWidth": 100,
+  "trailingComma": "es5",
+  "useTabs": false,
+  "tabWidth": 2,
+  "semi": true,
+  "bracketSpacing": true,
+  "singleQuote": true,
+  "arrowParens": "always"
+}

site/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ npm i
+```
+
+### Local Development
+
+```
+$ npm run start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+### Build
+
+```
+$ npm run build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+Using SSH:
+
+```
+$ USE_SSH=true npm run deploy
+```
+
+Not using SSH:
+
+```
+$ GIT_USER=<Your GitHub username> npm run deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

site/docs/concepts/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Concepts",
+  "position": 6,
+  "link": {
+    "type": "generated-index",
+    "description": "Concepts to OpenVINO GenAI."
+  }
+}

site/docs/concepts/beam-search.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 3
+---
+
+# Beam Search

site/docs/concepts/lora-optimization.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 2
+---
+
+# Lora Optimization

site/docs/concepts/optimization-techniques/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Optimization techniques",
+  "position": 4,
+  "link": {
+    "type": "generated-index",
+    "description": "Optimization techniques to OpenVINO GenAI."
+  }
+}

site/docs/concepts/optimization-techniques/continuous-batching.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 3
+---
+
+# Continuous Batching

site/docs/concepts/optimization-techniques/kvcache-eviction-algorithm.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 2
+---
+
+# KVCache Token Eviction Algorithm

site/docs/concepts/optimization-techniques/prefix-caching.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 4
+---
+
+# Prefix Caching

site/docs/concepts/optimization-techniques/speculative-decoding.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 1
+---
+
+# Speculative Decoding

site/docs/concepts/stateful-vs-stateless-models.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 1
+---
+
+# Stateful Models vs Stateless Models

site/docs/getting-started/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Getting Started",
+  "position": 1,
+  "link": {
+    "type": "generated-index",
+    "description": "Getting started guide for OpenVINO GenAI"
+  }
+}

site/docs/getting-started/introduction.mdx

@@ -0,0 +1,6 @@
+---
+sidebar_position: 1
+sidebar_label: Introduction
+---
+
+# Introduction to OpenVINO GenAI

site/docs/getting-started/quick-start-guide.mdx

@@ -0,0 +1,5 @@
+---
+sidebar_position: 3
+---
+
+# Quick Start Guide

site/docs/how-to-guides/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "How-to guides",
+  "position": 4,
+  "link": {
+    "type": "generated-index",
+    "description": "How-to guides to OpenVINO GenAI."
+  }
+}

site/docs/how-to-guides/build-chat-agent.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 6
+---
+
+# Build Chat Agent

site/docs/how-to-guides/hugging-face-to-openvino.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 2
+---
+
+# Convert HuggingFace Model to OpenVINO

site/docs/how-to-guides/image-generation.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 8
+---
+
+# Image Generation

site/docs/how-to-guides/llm.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 5
+---
+
+# LLM

site/docs/how-to-guides/lora-adapters.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 4
+---
+
+# Loading Multiple LoRA Adapters

site/docs/how-to-guides/model-download-hugging-face.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 1
+---
+
+# Download a Model from HuggingFace

site/docs/how-to-guides/model-scope-to-openvino.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 3
+---
+
+# Convert ModelScope Model to OpenVINO

site/docs/how-to-guides/speech-to-text.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 9
+---
+
+# Speech to Text

site/docs/how-to-guides/vlm.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 7
+---
+
+# VLM

site/docs/samples/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Samples",
+  "position": 5,
+  "link": {
+    "type": "generated-index",
+    "description": "Samples to OpenVINO GenAI."
+  }
+}

site/docs/samples/sample.md

@@ -0,0 +1,5 @@
+---
+sidebar_position: 1
+---
+
+# Sample

site/docs/use-cases/1-LLM-pipeline/_sections/_convert_model.mdx

@@ -0,0 +1,71 @@
+## Convert and Optimize Model
+
+<Tabs groupId="model-source">
+    <TabItem label="From Hugging Face" value="huggingface">
+        Use `optimum-intel` package to convert and optimize models:
+        ```bash
+        pip install optimum-intel[openvino]
+        ```
+
+        Download and convert a model to the OpenVINO IR format:
+        <Tabs groupId="export-precision">
+            <TabItem label="Compress weights to the int4 precision" value="int4">
+                ```bash
+                optimum-cli export openvino --model meta-llama/Llama-2-7b-chat-hf --weight-format int4 ov_llama_2_7b_int4 --trust-remote-code
+                ```
+            </TabItem>
+            <TabItem label="Keep full model precision" value="fp16">
+                ```bash
+                optimum-cli export openvino --model meta-llama/Llama-2-7b-chat-hf --weight-format fp16 ov_llama_2_7b_fp16 --trust-remote-code
+                ```
+            </TabItem>
+        </Tabs>
+
+        :::info
+
+        Check a full list of conversion options [here](https://huggingface.co/docs/optimum/en/intel/openvino/export).
+
+        :::
+
+        :::tip
+
+        You can also use [pre-converted LLMs](https://huggingface.co/collections/OpenVINO/llm-6687aaa2abca3bbcec71a9bd).
+
+        :::
+    </TabItem>
+    <TabItem label="From Model Scope" value="modelscope">
+        Use `modelscope` and `optimum-intel` packages to convert and optimize models:
+        ```bash
+        pip install modelscope optimum-intel[openvino]
+        ```
+
+        Download the required model to a local folder:
+        ```bash
+        modelscope download --model 'Qwen/Qwen2-7b' --local_dir model_path
+        ```
+
+        :::tip
+
+        Convert the model and compress weights:
+
+        <Tabs groupId="export-precision">
+            <TabItem label="INT4" value="int4">
+                ```bash
+                optimum-cli export openvino -m model_path --weight-format int4 ov_qwen2_7b_int4 --task text-generation-with-past
+                ```
+            </TabItem>
+            <TabItem label="INT8" value="int8">
+                ```bash
+                optimum-cli export openvino -m model_path --weight-format int8 ov_qwen2_7b_int8 --task text-generation-with-past
+                ```
+            </TabItem>
+            <TabItem label="FP16" value="fp16">
+                ```bash
+                optimum-cli export openvino -m model_path --weight-format fp16 ov_qwen2_7b_fp16 --task text-generation-with-past
+                ```
+            </TabItem>
+        </Tabs>
+
+        :::
+    </TabItem>
+</Tabs>