Skip to content

docs: rename manual serializers to custom serializers - #3896

Merged
chaokunyang merged 1 commit into
apache:mainfrom
chaokunyang:docs/custom-serializer-terminology
Jul 28, 2026
Merged

docs: rename manual serializers to custom serializers#3896
chaokunyang merged 1 commit into
apache:mainfrom
chaokunyang:docs/custom-serializer-terminology

Conversation

@chaokunyang

Copy link
Copy Markdown
Collaborator

Summary

  • standardize the repository on the canonical term custom serializer
  • destructively rename six guide, example, test, and fixture files and update every reference
  • align runtime comments, diagnostics, tests, benchmarks, specifications, READMEs, and agent guidance without keeping aliases or redirects

Why

Custom serializer describes an application-defined serialization implementation more precisely than manual serializer and is already the established term in several language guides. Keeping both terms created inconsistent documentation, filenames, test names, and diagnostics for the same concept.

Verification

  • stale terminology, path, ID, identifier, and filename scans: zero matches
  • relative links in 50 changed Markdown files: all targets exist
  • C#: format check and 312 tests
  • Dart: code generation, analysis, and 334 + 32 tests
  • Rust: full test suite and Clippy (allowing only the pre-existing constant-assertion lint)
  • Swift: format, lint, and 229 tests
  • Python: Ruff and 690 tests
  • Java: Spotless and compile with JDK 21
  • JavaScript: Prettier and ESLint
  • Go: gofmt and full tests
  • C++: clang-format check
  • Rust and Swift external-type benchmarks: compile checks

@chaokunyang
chaokunyang marked this pull request as ready for review July 28, 2026 11:46
@chaokunyang
chaokunyang merged commit 68c9186 into apache:main Jul 28, 2026
37 checks passed
chaokunyang added a commit to apache/fory-site that referenced this pull request Jul 28, 2026
## Summary

- rebuild the branch directly on the latest `fory-site` `main` after
apache/fory#3896
- sync the current zh-CN C#, Rust, and Swift custom serializer guides
with their canonical English owners
- keep filenames and document IDs on `custom-serializers.md` /
`custom_serializers`, with no legacy manual serializer aliases or paths
- update translated links to use the Docusaurus document ID and add the
canonical Chinese term `自定义序列化器`
- align `sum type` with the existing compiler terminology `联合类型`
- cancel superseded Deploy, Lint, and Check broken links runs for the
same event and Git ref

## Testing

- scoped Markdown lint and Prettier checks
- scoped YAML lint for all changed workflows
- stale path, ID, route, and terminology scans
- English/Chinese heading and code-fence structure comparison
- Deploy workflow `Unified Docs` sync
- `npm run download-avatars`
- `npm run build`
- `npm run typecheck`
- verified `/`, `/docs`, `/zh-CN/docs`, `/blog`, and the three zh-CN
`custom_serializers` routes
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