fifth icon indicating copy to clipboard operation
fifth copied to clipboard

Documentation Please

Open PythonLinks opened this issue 6 years ago • 2 comments

First thank you for all of the hard work.
Forth in GoLang. Brilliant.

Yesterday I tried out the Forth's written in Python. First 2 failed to work, third one looked sketchy, which is why I tried it last, but is really awesome.

So today, I am checking out the Go versions. Because i really want many small Forth interpreters. Your came up first. But like no documentation. Even a few paragraphs in the read me about the state of the project would be hugely informative. i do not need detailed docs of the words, but just a little background, history, context, to do lists. Something to give me a sense of where this project is, would hugely increse my confidence in it.

Hope that helps. Thanks again for writing it. Chris

PythonLinks avatar Mar 14 '20 11:03 PythonLinks

Thanks for your comment! I added some usage and todo list.

h8gi avatar Mar 16 '20 09:03 h8gi

That is a huge improvement.
It tells me how to start the interpreter. It tells me that I can start up lots of Forth machines.
It tells me the existing keywords.
The only part that scares me off is the todo list.
I did not understand what it meant. It sounds like the repl is not working, which scares me off. It would be great to find a Forth in GoLang which has a good first impression. Which inspires confidence. You are almost at that level. So what exactly do those todo items mean?

PythonLinks avatar Mar 16 '20 10:03 PythonLinks