Re: [PATCH v3 00/31] clean up and reorg Chinese kernel docs

[Alex Shi]

CC more active Chinese peoples.

Hi Harry,

Could you please give some comments as the patch series is updated to v3 and I can't see any problem of this series?

There could do more on the processing docs translation, but as the first step, we want comments from Chinese doc maintainer.

Thanks
Alex
Â
On 2019/3/8 11:08 äå, Alex Shi wrote:
> Hi All,
>
> The following patches change existing Chinese kernel docs to rst format
> and reorg them to make them alive in 'make htmldocs'.
>
> you can view the generated htmldocs from:
> 	http://176.122.172.82/translations/zh_CN/index.html 
>
> Or make and review docs on your self box:
>
> 	make htmldocs SPHINXDIRS=translations/zh_CN 
> 	lynx Documentation/output/translations/zh_CN/index.html
>
> Any comments are appreciated!
>
> V3 changes:
> 1, fix a zh_CN/index.rst display issue
> 2, update .mailmap for zh_CN transolators'r email address
>
> V2 changes:
> 1, change the disclaimer file to Chinese version,
> 2, replace the obsolete translator's email address in related files.
> 3, fix couple of format issues in couple files
>
> Cheers!
> Alex
>
>
> Alex Shi (31):
>   docs/zh_CN: add disclaimer file
>   docs/zh_CN: move process related docs into process dir
>   docs/zh_CN: change Chinese index to know process dir
>   docs/zh_CN: add index file into process dir
>   docs/zh_CN: rename HOWTO into process directory
>   docs/zh_CN: howto format changes
>   docs/zh_CN: rename SubmittingPatches for html links
>   docs/zh_CN: format the submitting-patches doc to rst
>   docs/zh_CN: rename stable_kernel_rules doc
>   docs/zh_CN: rst format change for stable-kernel-rules
>   docs/zh_CN: rename email-clients.txt as email-clients.rst
>   docs/zh_CN: do rst format for email-clients.rst
>   docs/zh_CN: rename volatile-consider-harmful doc
>   docs/zh_CN: volatile doc format changes
>   docs/zh_CN: rename SubmittingDrivers
>   docs/zh_CN: format submitting drivers as rst
>   docs/zh_CN: rename magic-numbers as rst doc
>   docs/zh_CN: format the magic-number doc as rst
>   docs/zh_CN: rename stable_api_nonsense.txt as stable-api-nonsense.rst
>   docs/zh_CN: format stable-api-nonsense
>   docs/zh_CN: update Li Yang's email address
>   mailmap: update Li Yang's email address
>   docs/zh_CN: update Zhang Wei's email address
>   mailmap: update email address for Triplex
>   docs/zh_CN: update TripleX chung's email address
>   docs/zh_CN: fix rst format errors in howto.rst
>   docs/zh_CN: fix indent issue in stable-api-nonsense file
>   docs/zh_CN: fix indent issue in submitting-drivers
>   docs/zh_CN: fix rst format issue in submitting-patch
>   docs/zh_CN: remove zh-kernel.org in MAINTAINERS
>   mailmap: update my obsolete email address
>
>  .mailmap                                      |   6 +
>  .../translations/zh_CN/disclaimer-zh_CN.rst   |   9 ++
>  Documentation/translations/zh_CN/index.rst    |  17 +-
>  .../translations/zh_CN/magic-number.txt       | 153 ------------------
>  .../translations/zh_CN/oops-tracing.txt       |   2 +-
>  .../zh_CN/{ => process}/coding-style.rst      |   0
>  .../email-clients.rst}                        |  53 +++---
>  .../zh_CN/{HOWTO => process/howto.rst}        |  69 +++++---
>  .../translations/zh_CN/process/index.rst      |  53 ++++++
>  .../zh_CN/process/magic-number.rst            | 151 +++++++++++++++++
>  .../stable-api-nonsense.rst}                  |  67 ++++----
>  .../stable-kernel-rules.rst}                  |  32 ++--
>  .../submitting-drivers.rst}                   |  34 ++--
>  .../submitting-patches.rst}                   |  60 ++++---
>  .../volatile-considered-harmful.rst}          |  35 ++--
>  Documentation/translations/zh_CN/sparse.txt   |   6 +-
>  MAINTAINERS                                   |   1 -
>  17 files changed, 408 insertions(+), 340 deletions(-)
>  create mode 100644 Documentation/translations/zh_CN/disclaimer-zh_CN.rst
>  delete mode 100644 Documentation/translations/zh_CN/magic-number.txt
>  rename Documentation/translations/zh_CN/{ => process}/coding-style.rst (100%)
>  rename Documentation/translations/zh_CN/{email-clients.txt => process/email-clients.rst} (82%)
>  rename Documentation/translations/zh_CN/{HOWTO => process/howto.rst} (95%)
>  create mode 100644 Documentation/translations/zh_CN/process/index.rst
>  create mode 100644 Documentation/translations/zh_CN/process/magic-number.rst
>  rename Documentation/translations/zh_CN/{stable_api_nonsense.txt => process/stable-api-nonsense.rst} (80%)
>  rename Documentation/translations/zh_CN/{stable_kernel_rules.txt => process/stable-kernel-rules.rst} (76%)
>  rename Documentation/translations/zh_CN/{SubmittingDrivers => process/submitting-drivers.rst} (86%)
>  rename Documentation/translations/zh_CN/{SubmittingPatches => process/submitting-patches.rst} (92%)
>  rename Documentation/translations/zh_CN/{volatile-considered-harmful.txt => process/volatile-considered-harmful.rst} (81%)
>