CX Code Contributor
- Dec 13, 2018
I don't like it either, but as it's in the language I have to cover it at least in the reference.I've always hated the multi-statement line concept
Looking at 'Variables and Constants' page it seems you're shooting for a complete beginner's guide to programming.
I guess you can't have a really useable reference guide and at the same time cover all the things a beginner needs to understand, but I try to write the introduction on each topic as easy to understand as possible. If the first lines of a chapter are hard to grasp for a newbie they won't put in the effort to go any further. An other thing is that I want the reference guide to cover most things you need at least once to avoid too much switching of information sources.Experience users can easily skip through these things.
If you are new to Cerberus X or programming in general and you want to get a deeper understanding of the language, the best way to read it is from start to finish using the forward links at the beginning and the end of each page. This is due to the fact that later chapters require at least a basic understanding of the concepts discussed in earlier chapters.
I tried this first, but it did'nt work out well. It took way to much vertical space, even with minimal margins between blocks. Even though I am open to layout suggestions and I will try to present a mockup with this.I'd prefer having lists with one entry per line
I won't ditch this unless it is replaced by something substantially better. In the long term it should be replaced by either a better F1 help or a searchable help site. To me this index is like looking up your aunts number in an old telephone book.That's where F1 leads to, if the keyword is ambiguous. I guess keeping it for that sole reason is reason enough.
Exactly. To be honest, I'd prefer most of the examples to be inside the docs and only a few to stay in this Cerberus/examples folder if they are something like a showcase of a game project or to show off the capabilities of CX. So it would change to something like a showcase folder.You're talking about the "Cerberus/examples" folder, right?
I'd prefer most of the examples to be inside the docs and only a few to stay in this Cerberus/examples folder if they are something like a showcase of a game project or to show off the capabilities of CX. So it would change to something like a showcase folder.