Time Nick Message 16:25 MTDiscord just going to mention https://github.com/minetest/minetest/pulls?q=is%3Aopen+is%3Apr+scancodes+ here 16:26 [MatrxMT] +1 18:49 MTDiscord just dropping in to say see https://newdev.luanti.org/ powered by https://github.com/wsor4035/devwiki - polishing off/finishing up content cleaning/filling in 19:45 Krock @wsor4035 How does that thing work? >> Error: Unable to locate config file or config directory. Perhaps you need to create a new site. Run `hugo help new` for details. 19:46 Krock well whatever. there's already a live preview which is good 19:46 MTDiscord assuming you have the extended hugo installed, following quickstart, hugo server 19:47 Krock just installed the "hugo" package and expected it to work out of the box. It's not so simple, I suppose. 19:48 MTDiscord you are in the cloned directory? that error sounds like your not 19:51 Krock I am. It's probably just a very old version from the distro repo (0.92.2) which doesn't yet work as documented online 20:14 MTDiscord cross posting to here, if people could poke around https://newdev.luanti.org/, its in theory done 20:15 MTDiscord for dead links/errors, that sort of thing. dont care about content assuming it matches live now 20:15 MTDiscord . s/matches/is similar 20:16 Krock I wonder whether ruben's modding book could substitute some of that content 20:16 Krock for API in specific 20:16 MTDiscord probably. the point is to get it converted and then open season on content changes 20:16 Krock oh! It's really just the dev wiki. my bad. So that's definitely separate. 20:17 MTDiscord if all goes well, ill probably do the regular wiki next 20:18 Krock I am rather sceptical of this workflow. Editing pages in the current Wiki is mostly painless whereas you'd need to commit and open a PR here 20:18 Krock You'd eventually get higher quality documentation, but on the other side, it'll be sparse if not outdated. 20:19 MTDiscord so, its painless aside from the completely minor issue of its near impossible to get wiki accounts, the wiki is slow in general, etc 20:19 Krock There's also a few markdown files in the minetest/minetest repo which document the direction and a few other things, which might have the same issue. 20:19 Krock you only need to get the account once, though 8) 20:20 MTDiscord as for quality of content, in both wikis is generally outdated and terrible 20:22 MTDiscord Krock: Why would the workflow include mandatory PRs? 20:22 MTDiscord I'd say for obvious things we could just directly edit. 20:22 MTDiscord 👆 this 20:23 Krock @luatic So contributors would get write access to the repository? 20:23 MTDiscord I would suppose so, yes. Basically using the repo as a wiki if you want to see it that way. 20:23 MTDiscord the plan is to transfer the repo to the org if you didnt see that previously 20:24 MTDiscord with the web interface, you dont even have to clone the repo. basically like using the current wiki 20:24 Krock hmm yes. I suppose normal contributors shouldn't have access to the dev wiki. The story would be different for the normal wiki. 20:25 Krock s/access/easy write access/ 20:25 MTDiscord there is a chance they might merge in the future 20:25 MTDiscord im to lazy to link the previous discussions 20:26 MTDiscord the dev wiki will probably only be edited by core devs, triagers, maybe doc team folks? 20:26 celeron55 i think this is good for the dev wiki which contains information written by developers, targeted at developers 20:26 MTDiscord i mainly did this since c55 gave the go ahead and wants it off his hands 20:26 celeron55 the "regular" wiki isn't so straightforward 20:26 MTDiscord the dev wiki is supposed to have information by and for modders too, no? 20:27 celeron55 it was mostly retired from that function already 20:27 MTDiscord uhhh 20:27 MTDiscord the regular wiki has basically one contributor. wuzzy, and occasionally myself and roller 20:27 MTDiscord i'm not sure we should mix the "core dev" wiki and modder resources / wikis 20:27 MTDiscord well it is already mixed, so where should we throw that stuff? 20:28 Krock I see. Zughy removed some API documentation pages which I remembered existing there 20:28 MTDiscord would it be a tragic loss if it went into the trashbin? 20:28 MTDiscord uh yeah? 20:28 MTDiscord if you want to rehash/bike shed the two wikis/mergine/whatever debate again. feel free. i just care about getting the dev wiki converted and live 20:29 MTDiscord currently 20:29 celeron55 it's possible that there needs to be a place for miscellaneous articles about modding 20:29 MTDiscord it is the only entrypoint for modders that isn't in the minetest/minetest repo 20:29 celeron55 and it's possible we want to create a new place for those 20:29 MTDiscord anyways minetest_docs was supposed to be the place for modder-centric docs 20:29 MTDiscord and minetest_docs is dead 20:29 MTDiscord yes 20:29 MTDiscord and then I made my own wiki with modder-centric docs 20:29 MTDiscord we can mix the two graves and make it a mass grave 20:30 celeron55 but i'm going to use this domain change as means to force myself out of having to host the devwiki 20:30 MTDiscord https://wiki.luanti.org/Database_backends this article is probably the one i send people to the most on the regular wiki 20:31 MTDiscord but now that the dev wiki is becoming appetising for readers and contributors, I had thought I could contribute some of that back 20:31 Krock the Dummy backend speed should be "insanely fast" 8) 20:31 MTDiscord well actually, it needs to generate the mapgen every time 8) 20:31 MTDiscord krock, feel free to wait the insanely long time to edit and publish that change 😛 20:33 MTDiscord anyways, if you would, please poke around the site, and send me any errors/bugs/whatever you find (https://newdev.luanti.org/) 20:33 [MatrxMT] RE Krock: "Zughy removed some API documentation pages which I remembered existing there" I've never deleted one single page as far as I remember 20:34 Krock Zughy: here's one of the 0 pages: https://dev.minetest.net/index.php?title=minetest.get_player_radius_area&action=edit&redlink=1 20:35 MTDiscord the reason those were deleted was because they were redundant with the documentation that was in lua_api.md 20:35 Krock (it wasn't important at all) 20:35 MTDiscord and they where outdated/wrong as well 20:35 [MatrxMT] oh maybe when ruben and I deleted some redundant pages like a couple of years ago 20:36 MTDiscord 2022 20:36 Krock almost yesterday 20:37 MTDiscord what I see would be useful for modder documentation on the dev wiki would be articles that don't repeat what is in the lua_api.md but give more information than what is in lua_api.md. it is a dry API reference document and doesn't give much more than that 20:38 MTDiscord that was what minetest docs was supposed to be 20:38 MTDiscord yeah. that was what minetest_docs was supposed to be. and then it turned into "let's rewrite lua_api.md" and then it died 20:38 Krock it would be a nice place to have examples. The lua_api.md file is getting out of hand slowly. 20:38 MTDiscord i might keep giving that jolts of life when im done with the wiki 20:41 MTDiscord Wait long enough and most open source LLMs will be able to write those examples, sadly 20:44 MTDiscord sure, when there not busy telling you that your text length 300 characters is actually 250 characters (yes, i had to deal with someone believing this) 20:45 MTDiscord I am excited/horrified for AI powered strlen