Hello,
Sent with ProtonMail Secure Email. ‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐ On Saturday, February 9, 2019 10:57 PM, Ben Ramsey <[email protected]> wrote: > > On Feb 9, 2019, at 11:55, azjezz [email protected] wrote: > > Another question i have in mind is, after migrating to GIT, is there any > > plan to switch to markdown instead of XML ? this would be a really great > > step for the PHP.net website, as we can host the documentation using GitHub > > Pages without having to worry about deployment etc. and we would just need > > to make a theme for Jeklly. > > This is a huge question that should involve input from the docs team on the > phpdocs mailing list. The XML files are in DocBook format, which has a lot of > tools to convert it into various formats (HTML, CHM, etc.), using many > different translations. Any effort to switch to something else (Markdown, > AsciiDoc, etc.) needs to support the functionality provided by DocBook and > needs to ensure that the translations can be maintained. > > It’s a lot of work to migrate the documentation project to Git because of the > complexities around how the documentation is generated for all the > translations. It’ll be even more work to migrate to a different documentation > format. As Peter suggested, this might take years. > > I suspect the documentation team will choose to stick with DocBook for the > foreseeable future. (Though, since it’s all XML, someone could create tools > to export the docs into Markdown or any other format, keeping the “source of > truth” in DocBook.) > > Cheers, > Ben I'm sorry but i don't see how the PHP.net manual is more complicated in any way than docs.microsoft.net ( they have been using GitHub pages for a long time now ). Translation is not the issue, i think the bigger issue here is the migration from XML to MD. if we keep on saying "migration is hard, lets wait" we will never do it. the first step would be to create tools that enable us to migrate to MD and wait till migration to Git from SVN is finished. -- PHP Webmaster List Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
