Re: Is Phix the new de facto standard for Eu programmers?
- Posted by petelomax Jan 26, 2021
- 2439 views
For Phix, the biggest obstacle for a beginner is the documentation, which includes everything plus the kitchen sink.
It would be much clearer if it could be broken up so that things like LiteZip, Curl, IUP, etc were in their own domains and platforms, and could be referenced when and if a programmer was ready for those things.
No one ever said that before. (You are probably numb to it, but surely it is ten times better than https://openeuphoria.org/docs/ - I mean, look at it honestly.)
Might the real problem simply be
Introduction Core Language Library Routines Other Libraries Recommended Tools Internals Glossary
I mean, it's not really communicating anything that, is it? No indication that you need to read the Core Language, and everything after that is reference only.
I will freely admit that I often get stuck on the "top-level" pages, with half a mind to just leave it blank. On details I'm fine, broad overview and narrative structure not so much.
Is not the problem simply that the Other Libraries page is, to put it bluntly, utter sh*te.
PS My pet hate is the official Ruby docs. I quite like the language, but every page seems to scroll forever, and for instance what the pig is this: https://ruby-doc.org/core-3.0.0/doc/syntax_rdoc.html - like the same bunch of irrelevant files you get everywhere on the left, and not one single link anywhere on the right hand side of that page??
The very best language document for navigation has to be https://www.w3schools.com/jsref/