It's often the case with Terminal Phase and projects like it that I can't think about where to start with hacking until I run the program or hop into a repl and start playing with functions and then I get into the zone of "oh right, these are all the things that need to be done!"

... org-mode helps too

@cwebber I honestly can't decide if I want to come back to Org-mode and literate programming for Racket-MUD, now that I'm not an absolute baby with Racket's syntax.

I miss being able to take notes and like, essay-write my code.

But I don't want devs to have to learn Racket, Org-mode, AND all the specialized gibberish that will come with a MUD engine.

SO I'm leaning toward "y'know, as long as the functions end up accessible, right it however the hell you want, org-mode or pure racket or scribl

@emsenn Oh I don't try doing literate programming with org-babel. It's just too much! And it doesn't work very well for the kind of live repl hacking I do.

org-mode is for a) my own organization of my thoughts b) writing up documentation. I don't expect anyone to use it to understand my code.

@emsenn That said there is a literate programming scribble mode that looks... pretty cool? But it's useless to try coding in it in emacs w/ racket-mode or geiser, you have to use DrRacket, which I'm not super motivated to do.

@cwebber I've tried it and it's... alright but for me it'd basically be relearning babel and without much of the capabilities i get with babel.

I do use DrRacket a lot when I'm writing my MUD though - and whenever i'm looking at someone else's code. I know i can look all that stuff up in emacs but I've just not learned and well - you follow me, you've seen how I stumbled rapidly from my last programming experience being python in 2012 to where I am now.

@cwebber *nod*

I do, though - I'll basically write out like I'm talking to an audience an essay of my intention. I'll use the repl to write the lines sometimes but then copy-paste them back into code blocks.

(And in fact, I often /am/ talking to an audience, cause i'll livestream without a mic so the essay is how i chat out.)

Iunno, I feel like how I understand programming has changed so much in the past fwe months, worrying about styling rn is a fool's errand. i'm still settling in.

@cwebber If I keep doing what I've been doing naturally, what I'll do to make Racket-MUD is:

1) hack in the REPL, naming functions things like make-womble/a, make-womble/b or whatever

2) when I'm done copy-pasting the best from the various what-i've-gots into a proper file and removing the versioning crap

3) write an essay going through that statement-by-statement, explaining it from intention forward.

So there'll be API/module docs, and then a collection of essays, hopefully usefully tagged

@cwebber "accessible" of course includes "documented in the standard racket way" which is its OWN load of rules with "use the word sequence here not list" and such. Which all make a lot of sense to have as rules.

Anyway that is to say the source code will probably end up with a bunch of different stylings to encourage contribution, but the inputs/outputs, and documentation will all be super-standardized.

Sign in to participate in the conversation

The social network of the future: No ads, no corporate surveillance, ethical design, and decentralization! Own your data with Mastodon!