metadoc.xml does not contain a <cat id="upgrade"> tag for the upgrade category, so guides within this category are not displayed in /doc/es/index.xml file. Besides doc/es/?catid=upgrade shows empty 2. chapter.
Created attachment 207009 [details, diff] metadoc.xml.patch
Thanks for that patch Chema, revised doc now in CVS.