mirror of
https://github.com/woodpecker-ci/woodpecker.git
synced 2026-02-22 01:50:34 +00:00
Merge branch 'origin/main' into 'next-release/main'
This commit is contained in:
43
docs/docs/92-development/40-deprecations.md
Normal file
43
docs/docs/92-development/40-deprecations.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# Deprecation Policy
|
||||
|
||||
## Pipeline Configuration Changes
|
||||
|
||||
Pipeline configuration (YAML syntax) changes follow a strict deprecation process to ensure users have sufficient time to migrate.
|
||||
|
||||
### Process Timeline
|
||||
|
||||
1. **Minor Version N.x - Add Deprecation Warning**
|
||||
- Linter shows a warning (not an error)
|
||||
- Old syntax remains functional
|
||||
- Documentation is updated to reflect the new syntax
|
||||
- Warning message includes guidance on required changes
|
||||
|
||||
2. **Major Version (N+1).0 - Warning Becomes Error**
|
||||
- Linter issues an error (pipeline fails)
|
||||
- Old syntax is no longer supported
|
||||
- Breaking change is documented in the migration guide
|
||||
- Users **must** update their configurations
|
||||
|
||||
3. **Minor Version (N+1).x - Code Cleanup**
|
||||
- Deprecated code paths are removed
|
||||
- Implementation is simplified/refactored
|
||||
- Parser no longer recognizes the old syntax
|
||||
|
||||
### Example
|
||||
|
||||
Old syntax: `secrets: [token]`
|
||||
New syntax: `environment: { TOKEN: { from_secret: token } }`
|
||||
|
||||
- **v2.5.0:** Deprecation warning added in linter; both syntaxes work
|
||||
- **v2.6-2.9:** Warning persists; both syntaxes remain functional
|
||||
- **v3.0.0:** Linter error; old syntax fails (breaking change)
|
||||
- **v3.1.0:** Deprecated code paths removed; parser simplified
|
||||
|
||||
### Implementation Checklist
|
||||
|
||||
When deprecating pipeline configuration syntax, ensure the following:
|
||||
|
||||
- [ ] Add linter warning in `/pipeline/frontend/yaml/linter/`
|
||||
- [ ] Update JSON schema in `/pipeline/frontend/yaml/linter/schema`
|
||||
- [ ] Add test cases for deprecated syntax
|
||||
- [ ] Update documentation to reflect the new syntax
|
||||
@@ -310,7 +310,7 @@
|
||||
"log_delete_error": "Ocorreu um erro ao excluir os registros de etapas",
|
||||
"view": "Ver pipeline",
|
||||
"cancel_info": {
|
||||
"superseded_by": "Substituído pelo pipeline #{pipelineId}",
|
||||
"superseded_by": "Substituído por #{pipelineId}",
|
||||
"canceled_by_user": "Cancelado por {user}"
|
||||
}
|
||||
},
|
||||
|
||||
@@ -322,7 +322,7 @@
|
||||
"log_delete_error": "删除步骤日志时发生了错误",
|
||||
"view": "查看流水线",
|
||||
"cancel_info": {
|
||||
"superseded_by": "#{pipelineId} 流水线已被取消",
|
||||
"superseded_by": "#{pipelineId} 已取消",
|
||||
"canceled_by_user": "{user} 已取消"
|
||||
}
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user