Andrew,]
thanks for your feedback!
On 02/25/2013 04:19 PM, Andrew Dunbar wrote:
- MediaWiki and node.js are cross-platform. Some of us are crazy enough
to use it on Windows but the docs are Unix-centric
- npm works great on Windows but stuff like
"curlhttps://npmjs.org/install.sh http://npmjs.org/install.sh | sudo sh" does not
I personally have not used Windows in a while, but if you have corresponding instructions for Windows then it would be great if you could add them. Perhaps in a subpage like http://www.mediawiki.org/wiki/Parsoid/Windows?
- Can parsoid currently be used without a local mediawiki install? this
instruction makes it seem that it cannot yet talking to people make it seem like it should work. Confusing:
these instructions were very geared to an installation with the VisualEditor for a local wiki. I have reworded it a bit to make it clear that you can run the web service without any config.
- Can you point to a remote MediaWiki instance or must it be local? Can
you leave it out?
You can just try the built-in wikis (see example links on the API front page) or test snippets using the forms.
- export NODE_PATH=node_modules is Unix-centric - what should Windows
users do?
This is probably no longer needed on Unix/Linux either. I have never used it and never had problems. Removed it from the documentation.
- The docs jump straight into "running the tests" - this doesn't seem
very interesting to people trying out parsoid for the first time - at least without much introduction. - It seems too "internal". Why not start by showing people how to convert a wikitext string directly from a command line? That's more likely to get somebody hooked.
Good point. Will add something to that effect.
- my test results were (with a week old repo): 1854 total passed tests,
1107 total failures
That means that Windows works just as well as Linux, which is great given that we have never tested it on Windows!
Gabriel