orion icon indicating copy to clipboard operation
orion copied to clipboard

Self-contained documentation and maybe namespacing

Open Abdillah opened this issue 3 years ago • 2 comments

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.

Abdillah avatar Jul 04 '21 03:07 Abdillah

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.

Wafelack avatar Jul 04 '21 07:07 Wafelack

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.

Abdillah avatar Jul 04 '21 08:07 Abdillah