[Sync-En] Revise the Yaf extension documentation (#5809) - #1179
Merged
Conversation
lacatoire
marked this pull request as ready for review
August 31, 2026 12:58
lacatoire
force-pushed
the
sync-en/1121-yaf
branch
from
August 31, 2026 19:29
5da2548 to
f367cf0
Compare
Follow up on the Yaf rewrite in php/doc-en#5809: remove the 17 pages that only re-documented inherited methods, add the 11 pages it introduced, and bring the remaining pages in line with the English at ddcf673 (052c737e for the three pages a later commit touched). Every page is translated: the description, parameter and return blocks that doc-en fills are filled here too, warn.undocumented.func is gone from the pages that are now documented, and no block is left half in English. Code comments and example strings are in Spanish, the outputs match the code they follow, and the link targets mirror doc-en. The overview pages were out of sync in ways the structure check cannot see, since it stops at para: constants.xml documented none of the twelve constants, was missing YAF_ERR_ACCESS_ERROR and listed YAF_ERR_AUTOLOAD_FAILED out of order; ini.xml still documented yaf.cache_config as a live directive while carrying the note saying it was removed in Yaf 3.0.0; appconfig.xml had lost the Yaconf tip. Several examples were stale or wrong and are fixed along the way: Yaf_Route_Map::__construct had controller and action swapped in both outputs, Yaf_Application::execute had lost the body of main() and its output, Yaf_Dispatcher::registerPlugin was truncated before the closing brace, Yaf_Response_Abstract::response called a translated method name, Yaf_View_Simple::assignRef still described a bug fixed in Yaf 2.1.4, Yaf_View_Simple::__construct used APPLICATOIN_PATH and a dropped option, and Yaf_Route_Supervar::__construct documented another supervar than the one its own example registered. Terminology is unified across the extension: namespace, plugin, renderizar and por omisión. Also ignore /en, so a local doc-en checkout cannot be committed again.
lacatoire
force-pushed
the
sync-en/1121-yaf
branch
from
August 31, 2026 19:56
f367cf0 to
cf0c884
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #1121
Sync with EN PR php/doc-en#5809 (commit ddcf673c59d1708557680946fbffeee361d7fca6).
Changes