bella icon indicating copy to clipboard operation
bella copied to clipboard

Improve Documentation

Open GenericProgrammer1234 opened this issue 2 years ago • 10 comments

This is a WIP, I have some more to do but I have started off with the language tour. I have added a table of contents and made clearer grouping.

GenericProgrammer1234 avatar Nov 07 '23 15:11 GenericProgrammer1234

Also does Bella have objects or not? -- Sorry if these questions are basic, I only viewed one to two examples and read the documentation you wrote.

GenericProgrammer1234 avatar Nov 07 '23 15:11 GenericProgrammer1234

No, Bella does not have objects.

I am wondering why you moved the Lists section before anything else? It was originally placed where it was so that concepts are introduced in order of usage.

MystPi avatar Nov 08 '23 21:11 MystPi

Actually that was a stupid question because if it did have objects then there would be a section about it.

Because the Lists section makes sense as a sub-section of Values and since lists are super basic plus that they aren't even used much in the documentation, I think it makes sense.

GenericProgrammer1234 avatar Nov 09 '23 07:11 GenericProgrammer1234

Also what stops you from making a function be part of a record basically making it an object?

GenericProgrammer1234 avatar Nov 09 '23 12:11 GenericProgrammer1234

Also what stops you from making a function be part of a record basically making it an object?

Nothing, however doing that would most likely be against the grain of functional programming and is not recommended.

MystPi avatar Nov 09 '23 12:11 MystPi

Also what stops you from making a function be part of a record basically making it an object?

Nothing, however doing that would most likely be against the grain of functional programming and is not recommended.

Okay so technically there are objects but they aren't recommended? -- Okay got it.

GenericProgrammer1234 avatar Nov 09 '23 13:11 GenericProgrammer1234

Also what stops you from making a function be part of a record basically making it an object?

Nothing, however doing that would most likely be against the grain of functional programming and is not recommended.

Okay so technically there are objects but they aren't recommended? -- Okay got it.

If that's how you define objects, then yes, records can be used like them.

MystPi avatar Nov 09 '23 19:11 MystPi

You may want to take a look at this file to see all of the available built-in functions.

MystPi avatar Nov 10 '23 14:11 MystPi

Thanks!

GenericProgrammer1234 avatar Nov 11 '23 10:11 GenericProgrammer1234

I'll get around to completing this eventually, I am just a bit busy.

GenericProgrammer1234 avatar Nov 12 '23 13:11 GenericProgrammer1234