Topic on Talk:Parsoid

Documentation should be updated for Parsoid/PHP

Hi, I'm new to using Mediawiki but I just wanted to comment and say that I think the Parsoid guide is poorly written and needs some serious improvements. It's constantly sidetracked by notes on obsolete options, or alternative installation issues etc, which results in a very confusing stream of information to parse.

I was unable to install Parsoid correctly following the official guide but I found this one much easier to follow: https://www.howtoforge.com/tutorial/how-to-install-visualeditor-for-mediawiki-on-centos-7/

While the one linked is only for a specific OS and server type, I think it is a better example of how a Parsoid installation tutorial should be structured. The current one is very muddy and the structure of it is not consistent, at least to the eyes of a newbie like me. I am a newbie, but I think I have a decent understanding of technical information writing and the current shape of the article is not a good example of that.

I'm sorry for the assessment of the documentation. It is community maintained so there's an opportunity for you to contribute improvements, if possible.

Setting up Parsoid has been a thorn in many a MediaWiki developers side and is one motivating factor in porting Parsoid from JavaScript to PHP, to be included in core.

Hopefully that will ease the burden of many peoples' setup moving forward.

I appreciate the feedback.

Hi @Arlolra is there a chance you could tell me when approximately the port will finish? I know it's very difficult to say, but if you had to take a wild guess, would you say it's going to be like ~6 months or more like 2 years? Thanks

The port is currently in process of being deployed to WMF's production cluster so, for all extents and purposes, it's done.

I think that is wonderful news. Is there a good place to follow along with updates on its development?

https://www.mediawiki.org/wiki/Parsing/Notes/Moving_Parsoid_Into_Core/Porting https://www.mediawiki.org/wiki/Parsoid/PHP