Myrial language reference about myria-web HOT 7 OPEN

+1

this would be incredibly helpful for "outside" users of myria like me.

from myria-web.

Here is an example template for such a page. Each of the links is a link directly to a Wiki page named after the keyword.

Thoughts, anyone @uwescience/myria ?

from myria-web.

Sweet. We could also auto generate documentation from the repo with readthedocs. It's easy to set up and up to date with the code. A simple example is http://dataset.readthedocs.org/

from myria-web.

Here's a thought: at one point, we were talking about making functions case-sensitive, weren't we? If so, things like the safediv keyword we use here would be lies...

(Right now, it seems to work: this program parses.

x = empty(y:float);
z = select safediv(5, y, 10) from x;
store(z, ans);

even though the function is named SafeDiv in raco. https://github.com/uwescience/raco/blob/master/raco/expression/expressions_library.py#L34)

from myria-web.

Hmm. Last I checked, readthedocs was exceptionally burdensome and a fairly bad fit for example-driven documentation. Note that we do NOT want to show the same docs we show to developers here -- we want docs meant for someone who is not at all used to looking at Python code. The docs we want to show here have essentially nothing to do with Python itself or the code structure in raco.

(E.g.,: how would we document the expressions library?)

from myria-web.

Fair enough. Since the expressions are scattered across the code and are initialized differently (as functions, composed, ...) it would probably be a pain to make it work with rtd.

from myria-web.

Here's a thought: at one point, we were talking about making functions case-sensitive, weren't we? If so, things like the safediv keyword we use here would be lies...

I was promised case sensitivity when I implement syntax highlighting, I remember ;-)

cc @7andrew7

from myria-web.