Documentation doesn't say much about memory management or how the runtime works #31
Description
The documentation doesn't seem to say much about the memory management at least not in the opening section, and regarding how the runtime handles memory management.
If the language is garbage collected, I would expect mentions on this page, perhaps under a separate heading with a longer explanation of memory management and potential caveats, as well as a quick mention in the introduction section whether programs in the language are usually garbage collected, ref counted, manually managed, ...: https://www.arlang.io/docs/Get%20started/basic
Similarly, I would expect the main home page https://www.arlang.io/ to answer a few basic technical questions at the bottom, like:
- Are programs typically garbage collected, or ref counted, or manually managed
- The concurrency model is already answered with fibers. However, there is no info on whether fibers use hardware threading.
- What is the runtime in general? Does it compile to machine code, does it compile to byte code, ...
- Does it use static typing, gradual inferred typing, dynamic typing, or some mix of these.
- What major operating systems are officially supported? I think what most people would like answered is Windows, Linux, macOS, and potentially FreeBSD or OpenBSD support.
- Is there a good and documented workflow to write programs that run on mobile?
- Is there any mature UI toolkit support, and would that require more dependencies than just whatever is written in the language itself and a C++ compiler?
Perhaps it would be a good idea to scrap the relatively wordy-yet-vague "Run anywhere", "Concurrent", "I/O Ready" columns, and to replace it with a more detailed feature table that gives an overview regarding the above points.
Having these questions answered quickly without going into the details will help interested users to figure out quickly if the language is suitable for their use case or not!
My apologies if all of these things are already answered in an obvious place, and I hope my issue is helpful.