search

fusionlanguage / fut

Fusion programming language. Transpiling to C, C++, C#, D, Java, JavaScript, Python, Swift, TypeScript and OpenCL C.
https://fusion-lang.org
GNU General Public License v3.0
1.77k stars 55 forks source link

Missing Documentation #66

Open Rudde opened 2 years ago

Rudde commented 2 years ago

I feel intimidated by Ć since there is very weak documentation on how to get started with it. The ci.md language reference is very limited, and with no syntax highlighter it hard to "feel out" what one can and can't do. I'm really missing something like a w3schools like introduction to the language to get started. Are there any plans for this, or something else?

pfusik commented 2 years ago

Yes, a tutorial is definitely needed! As for syntax highlighting, C# syntax highligting works well for me.

I want to work on both documenation and editor support (maybe even code navigation and completion). Which one do you consider more important as a newcomer?

Rudde commented 2 years ago

Without proper documentation and layout of what is possible in the language it's very hard to get started, with or without syntax highlighting. Started my days with PHP in MS Notepad, so SH is nice, but not required to code.

pfusik commented 2 years ago

See https://github.com/pfusik/cito/blob/master/doc/getting-started.md and let me know your comments!

I also plan to split the reference into a language tour and an easy-to-navigate reference of classes and methods.

pfusik commented 4 months ago

Much happened during these two years. Ć is now called Fusion, it is much more mature, self-hosted, runs natively and in a browser, has VSCode / Visual Studio / Vim plugins. Extending beginner-friendly documentation becomes a priority.