Add further details to onyx documentation

onyx-lang / onyx

✨ The compiler and developer toolchain for Onyx

https://onyxlang.io

BSD 2-Clause "Simplified" License

571 stars 20 forks source link

Add further details to onyx documentation #31

Open iamshreeram opened 11 months ago

iamshreeram commented 11 months ago

It would be helpful if there is a doc that talks about

Why should we choose onyx when we have Rust or Go or C when they already support web assembly?
Any statistics on performance benchmarking compared to other languages
What would be the best use-case where other languages would never be able to replace onyx?

Thanks! Btw, Congrats on releasing new programming eco-system.

brendanfh commented 11 months ago

Thank you! Those docs are coming soon.

I tried to have the essentials out for anyone starting for how to use the language, but I have not documented why you would use the language.

apahl commented 11 months ago

If I may add (apologies if I have overlooked it), a description of methods on structs (-> operator) and #inject would be nice to have in the documentation.

Also congrats from me on a very cool project.

DoctorGester commented 11 months ago

Some reflection usage examples (with actual useful applications) as well as implementation details (which runtime type info is getting into the executable, is it stored as actual struct data or is it inlined as constants etc) would be much appreciated as well.