docs icon indicating copy to clipboard operation
docs copied to clipboard

English overlay

Open markstory opened this issue 3 years ago • 2 comments

To aid in the development of partial translations we can copy over content from the english docs into the translation. This allows us to have translations that use :ref:, :doc:, :php:meth:, :php:class: links. In the past we would delete these links which cause build time errors, but that only furthers the divergence in the docs that is already naturally occurring.

Once we're happy with how this is working, we can centralize all of the 'toctree' files and no longer have to maintain multiple copies of those. This can also be used to slim down all the boiler plate code from all the translations which is a nice benefit.

Refs cakephp/authorization#199

markstory avatar Apr 21 '22 03:04 markstory

As long as we can see the build errors when TOC changes and a language's rst files need to be deleted or renamed, I'm good with this. That does not happen often currently, but we may yet update our docs.

othercorey avatar Apr 25 '22 02:04 othercorey

I'll continue to clean this up so that the output builds then. I'm predicting a large number of files removed as we have many translation stubs across the repo.

markstory avatar Apr 25 '22 15:04 markstory

This pull request is stale because it has been open 120 days with no activity. Remove the stale label or comment on this issue, or it will be closed in 15 days

github-actions[bot] avatar Aug 24 '22 00:08 github-actions[bot]