Skip to content

Feature/docs#9

Merged
416rehman merged 2 commits into
mainfrom
feature/docs
Apr 28, 2026
Merged

Feature/docs#9
416rehman merged 2 commits into
mainfrom
feature/docs

Conversation

@416rehman

Copy link
Copy Markdown
Owner

What does this PR do?
Adds docs as github pages

Related issues

How to test
visit https://416rehman.github.io/DeepZero/en/

Checklist

  • [ x ] ruff check . and ruff format --check . pass
  • [ x ] bandit -ll -ii -c pyproject.toml -r . passes
  • [ x ] pytest passes
  • [ x ] Tests added/updated if needed

Copilot AI review requested due to automatic review settings April 28, 2026 04:31
@416rehman
416rehman merged commit 02c3716 into main Apr 28, 2026
3 checks passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a Jekyll-based, multi-language documentation site under docs/ and deploys it to GitHub Pages, while updating repository meta/docs to point users to the new site.

Changes:

  • Introduce localized documentation pages (EN/FR/ZH-CN/ES/RU/JA) plus shared layout, styling, and JS for theme + language switching.
  • Add a GitHub Pages deployment workflow for the docs/ site and ignore Jekyll build artifacts.
  • Simplify READMEs and link them to the new documentation site; update contributing guidelines for doc translations.

Reviewed changes

Copilot reviewed 72 out of 81 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
docs/zh-CN/system/state-persistence.md Adds Simplified Chinese state persistence documentation.
docs/zh-CN/system/repo-structure.md Adds Simplified Chinese repository structure documentation.
docs/zh-CN/reference/pipeline-yaml.md Adds Simplified Chinese pipeline YAML reference.
docs/zh-CN/reference/included-pipeline.md Adds Simplified Chinese included pipeline reference.
docs/zh-CN/reference/cli.md Adds Simplified Chinese CLI reference.
docs/zh-CN/overview/quickstart.md Adds Simplified Chinese quickstart.
docs/zh-CN/overview/architecture.md Adds Simplified Chinese architecture overview.
docs/zh-CN/index.html Adds Simplified Chinese docs landing page.
docs/zh-CN/extensibility/built-in.md Adds Simplified Chinese built-in processors documentation.
docs/zh-CN/extensibility/building-custom.md Adds Simplified Chinese custom processor guide.
docs/serve.sh Adds a Docker-based local Jekyll serve helper script.
docs/ru/system/state-persistence.md Adds Russian state persistence documentation.
docs/ru/system/repo-structure.md Adds Russian repository structure documentation.
docs/ru/reference/pipeline-yaml.md Adds Russian pipeline YAML reference.
docs/ru/reference/included-pipeline.md Adds Russian included pipeline reference.
docs/ru/reference/cli.md Adds Russian CLI reference.
docs/ru/overview/quickstart.md Adds Russian quickstart.
docs/ru/overview/architecture.md Adds Russian architecture overview.
docs/ru/index.html Adds Russian docs landing page.
docs/ru/extensibility/built-in.md Adds Russian built-in processors documentation.
docs/ru/extensibility/building-custom.md Adds Russian custom processor guide.
docs/ja/system/state-persistence.md Adds Japanese state persistence documentation.
docs/ja/system/repo-structure.md Adds Japanese repository structure documentation.
docs/ja/reference/pipeline-yaml.md Adds Japanese pipeline YAML reference.
docs/ja/reference/included-pipeline.md Adds Japanese included pipeline reference.
docs/ja/reference/cli.md Adds Japanese CLI reference.
docs/ja/overview/quickstart.md Adds Japanese quickstart.
docs/ja/overview/architecture.md Adds Japanese architecture overview.
docs/ja/index.html Adds Japanese docs landing page.
docs/ja/extensibility/built-in.md Adds Japanese built-in processors documentation.
docs/ja/extensibility/building-custom.md Adds Japanese custom processor guide.
docs/index.html Adds root docs redirect page with language auto-detection.
docs/fr/system/state-persistence.md Adds French state persistence documentation.
docs/fr/system/repo-structure.md Adds French repository structure documentation.
docs/fr/reference/pipeline-yaml.md Adds French pipeline YAML reference.
docs/fr/reference/included-pipeline.md Adds French included pipeline reference.
docs/fr/reference/cli.md Adds French CLI reference.
docs/fr/overview/quickstart.md Adds French quickstart.
docs/fr/overview/architecture.md Adds French architecture overview.
docs/fr/index.html Adds French docs landing page.
docs/fr/extensibility/built-in.md Adds French built-in processors documentation.
docs/fr/extensibility/building-custom.md Adds French custom processor guide.
docs/es/system/state-persistence.md Adds Spanish state persistence documentation.
docs/es/system/repo-structure.md Adds Spanish repository structure documentation.
docs/es/reference/pipeline-yaml.md Adds Spanish pipeline YAML reference.
docs/es/reference/included-pipeline.md Adds Spanish included pipeline reference.
docs/es/reference/cli.md Adds Spanish CLI reference.
docs/es/overview/quickstart.md Adds Spanish quickstart.
docs/es/overview/architecture.md Adds Spanish architecture overview.
docs/es/index.html Adds Spanish docs landing page.
docs/es/extensibility/built-in.md Adds Spanish built-in processors documentation.
docs/es/extensibility/building-custom.md Adds Spanish custom processor guide.
docs/en/system/state-persistence.md Adds English state persistence documentation.
docs/en/system/repo-structure.md Adds English repository structure documentation.
docs/en/reference/pipeline-yaml.md Adds English pipeline YAML reference.
docs/en/reference/included-pipeline.md Adds English included pipeline reference.
docs/en/reference/cli.md Adds English CLI reference.
docs/en/overview/quickstart.md Adds English quickstart.
docs/en/overview/architecture.md Adds English architecture overview.
docs/en/index.html Adds English docs landing page.
docs/en/extensibility/built-in.md Adds English built-in processors documentation.
docs/en/extensibility/building-custom.md Adds English custom processor guide.
docs/assets/js/script.js Adds frontend behavior (theme + language switching + mobile sidebar).
docs/assets/css/style.css Adds site styling for docs UI and theming.
docs/_layouts/default.html Adds shared Jekyll layout with sidebar nav, language dropdown, SEO tags.
docs/_config.yml Adds Jekyll site configuration (title/description/url).
README.zh-CN.md Adds Simplified Chinese README pointing to docs and summarizing the project.
README.md Simplifies English README and points readers to the docs site.
README.fr.md Adds French README pointing to docs and summarizing the project.
CONTRIBUTING.md Adds documentation/translation contribution requirements and locale parity expectations.
.gitignore Ignores Jekyll build artifacts and caches.
.github/workflows/pages.yml Adds GitHub Pages workflow to build and deploy the docs/ site.
.github/workflows/ci.yml Fixes editable install quoting in CI step.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@@ -0,0 +1,204 @@
<!DOCTYPE html>
<html lang="en">

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<html lang="en"> is hard-coded, so every locale page will declare English to browsers/screen readers/search engines. Consider setting lang dynamically based on the current locale (e.g. from page.url/current_lang, or via a lang: front-matter field).

Suggested change
<html lang="en">
<html lang="{{ page.lang | default: site.lang | default: 'en' }}">

Copilot uses AI. Check for mistakes.
Comment on lines +17 to +37
<link rel="canonical" href="{{ site.url }}{{ page.url | replace:'index.html','' }}">

<!-- Favicon -->
<link rel="icon"
href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><g transform=%22translate(50,50) scale(0.8) rotate(45)%22><path d=%22M 0 0 L 40 -20 L 80 0 L 40 20 Z%22 fill=%22%232C3E50%22/><path d=%22M 0 0 L 0 20 L 40 40 L 80 20 L 80 0 L 40 20 Z%22 fill=%22%23E74C3C%22/></g></svg>">

<!-- Open Graph / Facebook / LinkedIn -->
<meta property="og:type" content="website">
<meta property="og:url" content="{{ site.url }}{{ page.url }}">
<meta property="og:title"
content="{% if page.title == 'Home' or page.url == '/' %}DeepZero: Automated Vulnerability Research at Scale{% else %}{{ page.title }} | DeepZero{% endif %}">
<meta property="og:description"
content="{{ page.description | default: site.description | default: 'Pipeline engine for hunting for zero-days at scale through LLM orchestration, static analysis, and tools like Ghidra' }}">
<meta property="og:site_name" content="DeepZero">
<meta property="og:image" content="https://repository-images.githubusercontent.com/416rehman/DeepZero">

<!-- Twitter / X -->
<meta property="twitter:card" content="summary_large_image">
<meta property="twitter:url" content="{{ site.url }}{{ page.url }}">
<meta property="twitter:title"
content="{% if page.title == 'Home' or page.url == '/' %}DeepZero: Automated Vulnerability Research at Scale{% else %}{{ page.title }} | DeepZero{% endif %}">

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Canonical/OG/Twitter URLs are built as {{ site.url }}{{ page.url }}, which drops site.baseurl when Pages builds with a project base path (typical for repo Pages). This can generate incorrect canonical/social URLs. Prefer {{ page.url | absolute_url }} (or {{ page.url | relative_url | prepend: site.url }}) so baseurl is included consistently.

Copilot uses AI. Check for mistakes.
Comment thread docs/index.html
Comment on lines +8 to +13
<link rel="alternate" hreflang="en" href="https://416rehman.github.io/DeepZero/en/">
<link rel="alternate" hreflang="zh" href="https://416rehman.github.io/DeepZero/zh-CN/">
<link rel="alternate" hreflang="fr" href="https://416rehman.github.io/DeepZero/fr/">
<link rel="alternate" hreflang="ru" href="https://416rehman.github.io/DeepZero/ru/">
<link rel="alternate" hreflang="es" href="https://416rehman.github.io/DeepZero/es/">
<link rel="alternate" hreflang="ja" href="https://416rehman.github.io/DeepZero/ja/">

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hreflang for Simplified Chinese is set to zh, but the actual locale path is zh-CN. For SEO correctness, align the hreflang value with the locale you serve (e.g. zh-CN, or zh-Hans if that’s what you intend).

Copilot uses AI. Check for mistakes.
Comment thread docs/index.html
Comment on lines +14 to +16
<meta http-equiv="refresh" content="0; url=en/">
<script>
const userLang = navigator.language || navigator.userLanguage;

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The page includes an immediate meta refresh to en/ (content="0; url=en/") as well as JS-based locale detection. The meta refresh can preempt the JS and effectively force English for many clients. If you want JS-based language selection, consider removing the meta refresh or moving it into a <noscript> block / adding a delay so JS can run first.

Copilot uses AI. Check for mistakes.
Comment thread docs/en/reference/cli.md
Comment on lines +49 to +53
### Execution Flags (`run`)
| --------- | ----------- |
| `TARGET` | Positional argument. Path to the analysis corpus (file or directory). |
| `-p, --pipeline` | Identifier, directory name, or discrete YAML file path. |
| `--clean` | Purge existing state directory prior to execution. |

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Execution Flags (run) table is missing its header row (it starts directly with the separator | --------- | ----------- |). Markdown tables require a header row like | Flag | Description | before the separator, otherwise rendering will be broken/inconsistent.

Copilot uses AI. Check for mistakes.
Comment thread README.md
- `ctx.shutdown_event` - threading.Event that is set on graceful shutdown

Place custom processors under `processors/` and reference them in YAML as `dir/file.py`.
For detailed setup instructions and example corpora, see the [Quickstart Documentation](https://416rehman.github.io/DeepZero/overview/quickstart.html).

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Quickstart documentation link points to https://416rehman.github.io/DeepZero/overview/quickstart.html, but the docs are served under language-prefixed paths (e.g. /en/overview/quickstart.html). This URL will 404 unless you have a separate redirect set up. Update the link to the correct language path (or to the docs root if you intend to rely on the language auto-redirect).

Suggested change
For detailed setup instructions and example corpora, see the [Quickstart Documentation](https://416rehman.github.io/DeepZero/overview/quickstart.html).
For detailed setup instructions and example corpora, see the [Quickstart Documentation](https://416rehman.github.io/DeepZero/en/overview/quickstart.html).

Copilot uses AI. Check for mistakes.
Comment thread README.zh-CN.md
deepzero run C:\drivers -p .\pipelines\loldrivers\pipeline.yaml
```

有关详细的设置说明和示例语料库,请参阅[快速开始文档](https://416rehman.github.io/DeepZero/overview/quickstart.html)。

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This Quickstart link targets /DeepZero/overview/quickstart.html, but the published docs live under locale directories (e.g. /DeepZero/zh-CN/overview/quickstart.html or /DeepZero/en/overview/quickstart.html). As written, the link will 404. Please update it to the correct locale path.

Suggested change
有关详细的设置说明和示例语料库,请参阅[快速开始文档](https://416rehman.github.io/DeepZero/overview/quickstart.html)
有关详细的设置说明和示例语料库,请参阅[快速开始文档](https://416rehman.github.io/DeepZero/zh-CN/overview/quickstart.html)

Copilot uses AI. Check for mistakes.
Comment thread README.fr.md
deepzero run C:\drivers -p .\pipelines\loldrivers\pipeline.yaml
```

Pour des instructions de configuration détaillées et des exemples de corpus, consultez la [Documentation de Démarrage Rapide](https://416rehman.github.io/DeepZero/overview/quickstart.html).

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This Quickstart link targets /DeepZero/overview/quickstart.html, but the published docs live under locale directories (e.g. /DeepZero/fr/overview/quickstart.html or /DeepZero/en/overview/quickstart.html). As written, the link will 404. Please update it to the correct locale path.

Suggested change
Pour des instructions de configuration détaillées et des exemples de corpus, consultez la [Documentation de Démarrage Rapide](https://416rehman.github.io/DeepZero/overview/quickstart.html).
Pour des instructions de configuration détaillées et des exemples de corpus, consultez la [Documentation de Démarrage Rapide](https://416rehman.github.io/DeepZero/fr/overview/quickstart.html).

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants