> 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
signature.asc
Description: Message signed with OpenPGP
