Show HN: A complete Bash parser in JavaScript transpiled from Go

Re:Show HN: A complete Bash parser in JavaScript transpiled ... by z3t4 on Thursday May 17, 2018 @02:26AM (#17089229)

Thanks for the package! When it comes to JavaScript - the code is the documentation. You look up methods etc in the source code. But as this is 30k lines of generated code it's not very fun to read in order to figure out how something works. So in this case documentation, tutorials and examples becomes very important! For example how do you find all functions, or how do you find all variables, or all variables available (in scope) from position row/col.

I know there are documentation for Go, but that is not super helpful for a JavaScript dev. We need samples ready to copy & paste. Think Stack Overflow (https://stackoverflow.com/) which is often the first result that comes up when you Google for something JavaScript related.

[ Parent | on HN ]

Re:Show HN: A complete Bash parser in JavaScript transpiled ... by mvdan on Thursday May 17, 2018 @07:42AM (#17090467)

That's a good point. I am adding more and more examples to the Go documentation these days.

Ideally I'd just point the JS people at the Go docs and examples, but the translation is not exactly one-to-one. This is why the README file published with the JS package has a complete example. I'll try to add a few more.

[ Parent | on HN ]

Re:Show HN: A complete Bash parser in JavaScript transpiled ... by z3t4 on Thursday May 17, 2018 @07:57AM (#17090540)

idea: Maybe the examples and documentation can be transpiled too !? Then you can have several tabs for each code snippet. Go, JavaScript, other. Some transpilations might end up weird, but you could fix those manually.

[ Parent | on HN ]