Skip to content

OSS-Docs-Tools/sync

Repository files navigation

@oss-docs/sync

This is the CLI which powers a docs translation repo. It's job is to handle a few things:

  • Pulling translations into the app repo (docs-sync pull)
  • Grabbing the english files from the localization repo (docs-sync get-en)
  • Validating the changes in the localization repo (docs-sync validate-against-en)
  • Updating a set of GitHub issues (update-github-issues)

localize.json

This CLI expects you to have a localize.json in the root of your localization repo.

{
    "app": "microsft/TypeScript-Website#v2",
    "issues": {
      "pt": 23,
      "zh": 44
    },
    "docsRoots": [
        { "name": "Playground", "from": "packages/playground-examples/copy/", "to": "docs/playground" },
        { "name": "TSConfig Reference", "from": "packages/tsconfig-reference/copy/", "to": "docs/tsconfig" },
        { "name": "Website Copy", "from": "packages/typescriptlang-org/src/copy/", "to": "docs/typescriptlang" },
        { "name": "Handbook", "from": "packages/documentation/copy/", "to": "docs/documentation" }
    ],
    "validate": {
        "ignoreFiles": ["docs/playground/*.js"]
      }
}

About

Tools for syncing docs repos

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published