File community translation issues with the tensorflow/docs-l10 tracker.
For general documentation issues, use the tracker in the tensorflow/tensorflow repo.
Please read the community translations section in the TensorFlow docs contributor guide.
General questions can be asked on the docs@tensorflow.org list, and there are a few language-specific docs lists to help coordinate communities. If a language is gaining momentum and contributors and a new language-specific list would be useful, file a GitHub issue.
The source-of-truth for technical documentation is the site/en directory in the tensorflow/docs repo. If, when translating, you find an issue in the source content, please send a separate pull request that fixes the upstream content.
To view translated content on tensorflow.org,
select the in-page language switcher or append ?hl=<lang>
to the URL. For
example, the English
TensorFlow 2 quickstart tutorial
can be read in:
- Korean: https://www.tensorflow.org/tutorials/quickstart/beginner?hl=ko
- Russian: https://www.tensorflow.org/tutorials/quickstart/beginner?hl=ru
- Or any of the supported languages in site/.
Subsites are doc collections for projects outside of the core TensorFlow in
the tensorflow/docs
repo. These docs usually live with their project in a
separate GitHub repository. For example, the docs for
tensorflow.org/federated live in the
tensorflow/federated
GitHub repo. For translations, mirror this structure within this
tensorflow/docs-l10n
repo (i.e. do not submit translation pull requests to the
subsite project repo).
The following sections are not included in the community translations project. TensorFlow.org does not translate API reference, and uses an internal system for landing pages and release-sensitive documentation. Please do not translate the following sections:
- Any
/images/
directories. - Any
/r1/
directories (TensorFlow 1.x docs). - The
/install/
directory. - API reference including
/api_docs/
and/versions/
directories. - Navigation:
_book.yaml
and_toc.yaml
files. - Overview pages such as
_index.yaml
,index.html
, andindex.md
.
Please follow the
TensorFlow documentation style guide
and the
Google developer docs style guide,
when applicable. Additionally, language-specific style may be agreed upon by the
community—see the README.md
file within a site/<lang>/
directory. Community
proposals and communication can take place over pull request comments or
language-specific mailing lists (if available).
To reduce diff-churn on notebook pull requests and make reviews easier, please use the nbfmt tool or download the notebook from Google Colab.