Hey, help me out... I want the #Spritely Golem demo to be as understandable as possible. I know, I haven't written all the docs yet, but what's easier for you to read:
- All in one file, like this: https://gitlab.com/spritely/golem/blob/master/golem.rkt
- Split into multiple files: https://gitlab.com/spritely/golem/tree/breakup
Pls let me know! Your #bikeshed feedback appreciated!
whether or not to split seems split, but I did know I was asking friends to help me paint this #bikeshed
@cwebber I'm a big fan of the all in one file version for tutorials and such
@cwebber All in one file is easier to read as long as its not too long, but I prefer when it's split into multiple files. However, in the latter case, you could use conventions of racket packages so that the entry point is easier to recognize.
A readme would be delightful.
@Just_a_Galadin Yes that's coming soon :)
@cwebber All in one file.
@cwebber Single file is easier to scan through, if kept small.
Having said that, I'd assume that people will use the demos as boilerplate for starting their own projects, so I'd organize it however I think the project should be structured. If that is multiple files, then I'd include a README with notes about what is where.
@cwebber What about a README where each chapter/section is also a separate file that just is included in the main file?
@FiXato are you asking for literate programming? because it sounds like you're asking for literate programming ;)
I usually prefer the one file approach because it's easy to scan through. A multiple file approach requires a tutorial in which you can have the reader create files on the go, otherwise you don't really know where to start, in which order to read them, and why they're here. Anyway your project looks really cool, I'm glad someone is picking up #Racket to make such an ambitious project. Good luck!
@cwebber yeah why not docs first implementation 2.?
Also if they are so small they should be easy to implement in different languages? I think a lot, like a lot of people don't have the mindset of functional programing only. That's why having js or python (plz!! Python 😊) or any other c style implementation as well would help many people.