Wafelack / orion

Orion is a high level, purely functional programming language with a LISP based syntax.
GNU General Public License v3.0
238 stars 10 forks source link

Self-contained documentation and maybe namespacing #15

Open Abdillah opened 3 years ago

Abdillah commented 3 years ago

Hello @Wafelack, This is an interesting language written in my favorite language. I have some discussion regarding the roadmap.

What do you think about including a documentation inside the binding? It is interesting on how bindings are separated from the value, even from the function at all times. But, I'm curious if–like other lisp–we can put the documentation into the binding, especially the standard library. We can then inspect it in the REPL and that will enable best practice enforced when making libraries.

Do you plan to have namespace? Or even module? More roadmap? Curiously, I imagine this toy language (despite already good) will scale one day. I'm interested to see some namespace or module system. Well, currently I'm learning the source, but I'd like to hear the roadmap or plan that you may have devised.

Wafelack commented 3 years ago

Hello,

What do you think about including a documentation inside the binding ?

What do you mean ? Writing a documentation above the declarations ? Like this ?

Do you plan to have namespace ? Or even module ? More roadmap ?

I'll probably add an export thing in order to have private stuff in source files.

Abdillah commented 3 years ago

What do you mean ? Writing a documentation above the declarations ? Like this ?

Yes kinda, or maybe inspectable like in Python or Emacs Lisp.

I'll probably add an export thing in order to have private stuff in source files.

Sure, that will be good.