Skip to content

Commit a70295c

Browse files
morningmanclaude
andauthored
[refactor] retire legacy docs/ current tree and clean up dead hooks (#3645)
Dev docs migrated to the docs-next plugin and the legacy plugin runs with includeCurrentVersion: false, so docs/ and i18n/zh-CN/.../current/ were no longer being compiled. Remove the source trees plus all the CI / governance / i18n hooks that still referenced them. Deletions: - docs/ (1504 files), i18n/zh-CN/docusaurus-plugin-content-docs/current/ (1518 files), and current.json - sidebars.ts (legacy plugin sidebar; unused under includeCurrentVersion: false) - .github/workflows/check-legacy-docs-frozen.yml (legacy-only gate) - crowdin.yml (dead config; no workflow invokes Crowdin and target i18n/ja does not exist) - tools/maintainers.json + tools/check_review.py + .github/workflows/approve-check.yml (dormant maintainer-approval gate; the workflow was entirely commented out) Updates: - docusaurus.config.js: drop sidebarPath for the legacy plugin - .github/workflows/build-check.yml: drop dead docs/* / zh-current / sidebars.ts case branches - .github/workflows/manual-i18n-translate-workflow.yaml: default source_dir docs -> docs-next - .docs-governance/rules.yml + owners.yml: drop 'current' version, the docs / zh-current content roots, related doc_type / sync_policy entries, and legacy paths in each owner block - scripts/docs-governance/{manifest,lint-i18n-sync}.js: drop legacy current branches from path resolution; STRONG_SYNC_VERSIONS no longer includes 'current' - local_build_docs.sh: stop populating legacy current dirs; only the versioned_docs reimport remains --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 069d354 commit a70295c

3,173 files changed

Lines changed: 349 additions & 424615 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.docs-governance/owners.yml

Lines changed: 0 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -11,74 +11,55 @@ owners:
1111
- name: sql-functions
1212
owner: "@zclllyybb"
1313
paths:
14-
- "docs/sql-manual/sql-functions/**"
1514
- "versioned_docs/version-*/sql-manual/sql-functions/**"
16-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/**"
1715
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/sql-manual/sql-functions/**"
1816
doc_types:
1917
- sql_function
2018

2119
- name: sql-statements
2220
owner: "@apache/doris-sql-reviewers"
2321
paths:
24-
- "docs/sql-manual/sql-statements/**"
2522
- "versioned_docs/version-*/sql-manual/sql-statements/**"
26-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/**"
2723
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/sql-manual/sql-statements/**"
2824

2925
- name: install-and-deploy
3026
owner: "@apache/doris-website-maintainers"
3127
paths:
32-
- "docs/install/**"
3328
- "versioned_docs/version-*/install/**"
34-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/install/**"
3529
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/install/**"
3630

3731
- name: lakehouse-and-ecosystem
3832
owner: "@apache/doris-website-maintainers"
3933
paths:
40-
- "docs/lakehouse/**"
41-
- "docs/ecosystem/**"
4234
- "versioned_docs/version-*/lakehouse/**"
4335
- "versioned_docs/version-*/ecosystem/**"
44-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/**"
45-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/ecosystem/**"
4636
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/lakehouse/**"
4737
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/ecosystem/**"
4838

4939
- name: data-operate
5040
owner: "@apache/doris-website-maintainers"
5141
paths:
52-
- "docs/data-operate/**"
5342
- "versioned_docs/version-*/data-operate/**"
54-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/**"
5543
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/data-operate/**"
5644

5745
- name: admin-and-observability
5846
owner: "@apache/doris-website-maintainers"
5947
paths:
60-
- "docs/admin-manual/**"
61-
- "docs/observability/**"
6248
- "versioned_docs/version-*/admin-manual/**"
6349
- "versioned_docs/version-*/observability/**"
64-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/**"
65-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/observability/**"
6650
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/admin-manual/**"
6751
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/observability/**"
6852

6953
- name: ai-docs
7054
owner: "@apache/doris-website-maintainers"
7155
paths:
72-
- "docs/ai/**"
7356
- "versioned_docs/version-*/ai/**"
74-
- "i18n/zh-CN/docusaurus-plugin-content-docs/current/ai/**"
7557
- "i18n/zh-CN/docusaurus-plugin-content-docs/version-*/ai/**"
7658

7759
- name: website-framework
7860
owner: "@apache/doris-website-maintainers"
7961
paths:
8062
- "docusaurus.config.js"
81-
- "sidebars.ts"
8263
- "sidebarsCommunity.json"
8364
- "sidebarsReleases.json"
8465
- "versioned_sidebars/**"

.docs-governance/rules.yml

Lines changed: 3 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -31,27 +31,15 @@ versions:
3131
- "4.x"
3232
- "3.x"
3333
- "2.1"
34-
- current
3534
archived:
3635
- "2.0"
3736
- "1.2"
3837
default_version: "4.x"
39-
current_route_version: dev
4038
blocking_scope:
4139
active_versions: true
4240
archived_versions: false
43-
version_labels:
44-
current: Dev
4541

4642
content_roots:
47-
docs:
48-
plugin: main_docs
49-
locale: en
50-
version: current
51-
source_root: docs
52-
route_base: "/docs/dev"
53-
sidebar: sidebars.ts
54-
blocking_scope: true
5543
versioned_docs:
5644
plugin: main_docs
5745
locale: en
@@ -60,14 +48,6 @@ content_roots:
6048
route_base_pattern: "/docs/{version}"
6149
sidebar_pattern: "versioned_sidebars/version-{version}-sidebars.json"
6250
blocking_scope: active_versions_only
63-
zh_current_docs:
64-
plugin: main_docs
65-
locale: zh-CN
66-
version: current
67-
source_root: i18n/zh-CN/docusaurus-plugin-content-docs/current
68-
route_base: "/zh-CN/docs/dev"
69-
sidebar: sidebars.ts
70-
blocking_scope: true
7151
zh_versioned_docs:
7252
plugin: main_docs
7353
locale: zh-CN
@@ -164,9 +144,6 @@ doc_id:
164144
- "Prefix plugin name for non-main-docs content, for example community:join-community."
165145
- "Do not include locale or version in doc_id."
166146
examples:
167-
- source_path: "docs/gettingStarted/what-is-apache-doris.md"
168-
doc_id: "gettingStarted/what-is-apache-doris"
169-
sync_group_id: "main_docs:gettingStarted/what-is-apache-doris"
170147
- source_path: "versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/string-functions/concat.md"
171148
doc_id: "sql-manual/sql-functions/scalar-functions/string-functions/concat"
172149
sync_group_id: "main_docs:sql-manual/sql-functions/scalar-functions/string-functions/concat"
@@ -176,7 +153,6 @@ doc_id:
176153

177154
route_path:
178155
rules:
179-
- "current English docs route to /docs/dev/{doc_id} unless front matter slug overrides the final segment."
180156
- "default version 4.x route remains /docs/4.x/{doc_id}."
181157
- "localized routes prefix locale, for example /zh-CN/docs/4.x/{doc_id}."
182158
- "community, releases, and blog use their configured routeBasePath."
@@ -186,9 +162,8 @@ doc_type_detection:
186162
ordered_rules:
187163
- doc_type: sql_function
188164
path_patterns:
189-
- "^docs/sql-manual/sql-functions/"
190165
- "^versioned_docs/version-[^/]+/sql-manual/sql-functions/"
191-
- "^i18n/zh-CN/docusaurus-plugin-content-docs/(current|version-[^/]+)/sql-manual/sql-functions/"
166+
- "^i18n/zh-CN/docusaurus-plugin-content-docs/version-[^/]+/sql-manual/sql-functions/"
192167
required_sections:
193168
en:
194169
- Description
@@ -205,9 +180,8 @@ doc_type_detection:
205180
rollout_level: blocking_after_week_5
206181
- doc_type: sql_statement
207182
path_patterns:
208-
- "^docs/sql-manual/sql-statements/"
209183
- "^versioned_docs/version-[^/]+/sql-manual/sql-statements/"
210-
- "^i18n/zh-CN/docusaurus-plugin-content-docs/(current|version-[^/]+)/sql-manual/sql-statements/"
184+
- "^i18n/zh-CN/docusaurus-plugin-content-docs/version-[^/]+/sql-manual/sql-statements/"
211185
rollout_level: warning
212186
- doc_type: release_notes
213187
path_patterns:
@@ -225,9 +199,8 @@ doc_type_detection:
225199
rollout_level: warning
226200
- doc_type: feature_doc
227201
path_patterns:
228-
- "^docs/(install|lakehouse|data-operate|table-design|admin-manual|query-data|query-acceleration|compute-storage-decoupled|ai|ecosystem|db-connect)/"
229202
- "^versioned_docs/version-[^/]+/(install|lakehouse|data-operate|table-design|admin-manual|query-data|query-acceleration|compute-storage-decoupled|ai|ecosystem|db-connect)/"
230-
- "^i18n/zh-CN/docusaurus-plugin-content-docs/(current|version-[^/]+)/(install|lakehouse|data-operate|table-design|admin-manual|query-data|query-acceleration|compute-storage-decoupled|ai|ecosystem|db-connect)/"
203+
- "^i18n/zh-CN/docusaurus-plugin-content-docs/version-[^/]+/(install|lakehouse|data-operate|table-design|admin-manual|query-data|query-acceleration|compute-storage-decoupled|ai|ecosystem|db-connect)/"
231204
expected_sections:
232205
- overview
233206
- quick_start_or_basic_usage
@@ -249,20 +222,10 @@ sync_policy:
249222
report_only_locales:
250223
- ja
251224
version_rules:
252-
- when: "source version is current"
253-
required_counterparts:
254-
- locale: zh-CN
255-
version: current
256-
recommended_counterparts:
257-
- locale: en
258-
version: "4.x"
259225
- when: "source version is 4.x"
260226
required_counterparts:
261227
- locale: zh-CN
262228
version: "4.x"
263-
recommended_counterparts:
264-
- locale: en
265-
version: current
266229
- when: "source version is 3.x"
267230
required_counterparts:
268231
- locale: zh-CN
@@ -294,7 +257,6 @@ severity:
294257

295258
seo_policy:
296259
indexable_roots:
297-
- docs
298260
- versioned_docs
299261
- i18n/zh-CN/docusaurus-plugin-content-docs
300262
- community

.github/workflows/approve-check.yml

Lines changed: 0 additions & 43 deletions
This file was deleted.

.github/workflows/build-check.yml

Lines changed: 0 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -86,24 +86,11 @@ jobs:
8686
# Check each changed file and map to doc version
8787
while IFS= read -r file; do
8888
case "$file" in
89-
# English legacy current dir — no longer compiled
90-
# (dev moved to docs-next plugin). PR #3610 forbids
91-
# modifying these files; if they change anyway, fall
92-
# through to a minimal default-version smoke build.
93-
docs/*)
94-
VERSIONS="4.x,$VERSIONS"
95-
;;
9689
# English versioned docs
9790
versioned_docs/version-*/*)
9891
ver=$(echo "$file" | sed -n 's|versioned_docs/version-\([^/]*\)/.*|\1|p')
9992
VERSIONS="${ver},$VERSIONS"
10093
;;
101-
# Chinese legacy current dir — no longer compiled
102-
# (see docs/* note above).
103-
i18n/zh-CN/docusaurus-plugin-content-docs/current/*)
104-
VERSIONS="4.x,$VERSIONS"
105-
LOCALES="en,zh-CN"
106-
;;
10794
# Chinese versioned docs
10895
i18n/zh-CN/docusaurus-plugin-content-docs/version-*/*)
10996
ver=$(echo "$file" | sed -n 's|i18n/zh-CN/docusaurus-plugin-content-docs/version-\([^/]*\)/.*|\1|p')
@@ -114,12 +101,6 @@ jobs:
114101
i18n/zh-CN/docusaurus-plugin-content-docs-community/*|i18n/zh-CN/code.json)
115102
LOCALES="en,zh-CN"
116103
;;
117-
# Sidebar for legacy current — no longer compiled
118-
# (legacy plugin uses includeCurrentVersion: false).
119-
# Fall through to minimal default-version build.
120-
sidebars.ts)
121-
VERSIONS="4.x,$VERSIONS"
122-
;;
123104
# Versioned sidebars: extract version from filename
124105
# e.g. versioned_sidebars/version-4.x-sidebars.json → 4.x
125106
versioned_sidebars/version-*-sidebars.json)

.github/workflows/check-legacy-docs-frozen.yml

Lines changed: 0 additions & 55 deletions
This file was deleted.

.github/workflows/manual-i18n-translate-workflow.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ on:
66
source_dir:
77
description: "Directory containing English docs to translate"
88
required: true
9-
default: "docs"
9+
default: "docs-next"
1010
target_dir:
1111
description: "Target i18n root directory for Japanese docs"
1212
required: true

community/source-install/compilation-with-ldb-toolchain.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@ $ USE_AVX2=0 sh build.sh
139139
$ BUILD_TYPE=Debug sh build.sh
140140
```
141141

142-
This script first compiles the third-party libraries and then the Doris components (FE, BE, MS). The compilation output can be found in the `output/` directory. MS stands for Meta Service, which a module of Doris in the compute-storage decoupled mode. For more information about MS, refer to this [doc](../../docs/compute-storage-decoupled/compilation-and-deployment.md).
142+
This script first compiles the third-party libraries and then the Doris components (FE, BE, MS). The compilation output can be found in the `output/` directory. MS stands for Meta Service, which a module of Doris in the compute-storage decoupled mode. For more information about MS, refer to this doc.
143143

144144
## Pre-compile third-party libraries
145145

crowdin.yml

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)