Version 1.2.0 of the document

- A bunch of edits in the article
- Moving to mkdocs
- Setting up Github CI

---------

Co-authored-by: Paul Radley <noemail>

.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: Build and Deploy MkDocs
+
+on:
+  push:
+    branches:
+      - $default-branch
+
+    workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Install Dependencies
+        run: pip install -r requirements.txt
+      - name: Build
+        run: mkdocs build --strict
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './build'
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,2 @@
+build/
+venv/

README.md

@@ -1,22 +1,9 @@
 # Why cannot you set up Xdebug?
 
-> ℹ️ Use issues tab to suggest changes
-
-Most users experience difficulties with setting up [Xdebug](https://xdebug.org/) in their development environments. The problem has deteriorated due to several reasons:
-
-- Insufficient understanding of Xdebug work
-- An overload of ambiguous and inaccurate google-answers
-- No out-of-the-box solution to run "in one click"
-
-As long as the last two reasons are hard to affect, the focus of the article is decreasing impact of the first reason. So the goal is to explain how Xdebug does work under the hood, how IDE does work with Xdebug, and how the browser side has to work. The narrative format will help you systematize knowledge in an orderly manner. As a result, the acquired knowledge will reduce efforts on setting Xdebug up in an unfamiliar environment.
-
-In addition, you will gain insights into the following related questions: what is DBGp Proxy, why you should not use Xdebug Cloud and how to set up Xdebug in nonstandard environments (like SPA application). You won't gain information about instructions for installing Xdebug extension, instructions for using the debugger.
-
-The document is presented in two languages:
-
-- [English](./xdebug_en.md)
-- ~~[Русский](./xdebug_ru.md)~~ deprecated
+The article is [here](https://paulradley.github.com/why-cannot-you-set-up-xdebug)
 
 ### TODO List
 
-- WSL2 environment
+- WSL2 environment
+- SEO TAGS
+- Google Analytics

docs/assets/extra.css

@@ -0,0 +1,14 @@
+.md-typeset .admonition,
+.md-typeset details {
+  border-width: 0;
+  border-left-width: 4px;
+  font-size: .75rem;
+}
+
+.md-typeset table:not([class]) {
+    border-top: 0
+}
+
+.md-typeset th {
+  display: none;
+}