Minetest logo

IRC log for #minetest-docs, 2024-12-14

| Channels | #minetest-docs index | Today | | Google Search | Plaintext

All times shown according to UTC.

Time Nick Message
05:00 MTDiscord joined #minetest-docs
20:30 MTDiscord <wsor4035> im merging https://github.com/minetest/dev.luanti.org/pull/7 in 10 minutes
20:32 MTDiscord <greenxenith> So question ... what is the dev wiki actually for?
20:33 MTDiscord <wsor4035> my main goal was to get it converted and updated (branding wise, etc). as for merging the wev and main wiki ideas, welcoming open discussion on that
20:34 MTDiscord <wsor4035> the main point of it currently is dev processes and rules
20:34 MTDiscord <greenxenith> Thanks, GitHub
20:34 MTDiscord <greenxenith> https://cdn.discordapp.com/attachments/926231483155378176/1317590512403746909/image.png?ex=675f3d49&amp;is=675debc9&amp;hm=f70488c6c8aff603639a37534020d14aa1ad6acd0826adf5fd2988b38abd508d&amp;
20:34 MTDiscord <greenxenith> So like ... why should luanti documentation and dev wiki be any different (this is a hypothetical question)
20:36 MTDiscord <wsor4035> desour had a pr to move some of the core stuff from the dev site to the minetest repo, iirc it died
20:37 MTDiscord <josiah_wi> Thank you for moving discussion here, wsor.
20:37 MTDiscord <josiah_wi> The list of threads has the thread names and their responsibilities all on the same level of bullet points.
20:37 MTDiscord <rollerozxa> if you look at the bottom there is an "Edit this page" link that will take you directly to the github web interface, and it will then prompt you to make a PR 😄
20:37 MTDiscord <josiah_wi> Ooh, great.
20:38 MTDiscord <greenxenith> Not sure if the web interface lets you alter media
20:38 MTDiscord <wsor4035> web editor will if nothing else
20:38 MTDiscord <wsor4035> the vscode one launched via .
20:38 MTDiscord <celeron55> For the record: We organized the repo and DNS move in private with wsor and then I stated to wsor (and now here) that this indeed is a project to be organized under the docs team with as much freedom as the docs team can handle
20:39 MTDiscord <rollerozxa> well josiah can do the text changes, and I was going to replace the images
20:39 MTDiscord <greenxenith> I dont think we have repo perms, because I wanted to put the url in the repo url field
20:39 MTDiscord <wsor4035> https://cdn.discordapp.com/attachments/926231483155378176/1317591846700060802/image.png?ex=675f3e87&amp;is=675ded07&amp;hm=eb6e3bce20b4878253c2b1ab6243b79f996399652859f501f4aa34c0bc78b6a7&amp;
20:39 MTDiscord <rollerozxa> I do seem to have some merge perms at least, as a docs member
20:39 MTDiscord <wsor4035> you should?
20:39 MTDiscord <celeron55> (I gave wsor a lot of permissions, ask him for repo settings)
20:40 MTDiscord <wsor4035> your in the docs team green, maybe just refresh
20:41 MTDiscord <greenxenith> Might have to be a maintainer to edit repo settings
20:41 MTDiscord <celeron55> Well, I'll give GreenXenith more privs also
20:42 MTDiscord <wsor4035> are you talking about this green?
20:42 MTDiscord <wsor4035> https://cdn.discordapp.com/attachments/926231483155378176/1317592608968540200/image.png?ex=675f3f3d&amp;is=675dedbd&amp;hm=0c7eb6cae6e2e5f08b87b0a642f98b68a606b8977c2c436725766f1c72b86a26&amp;
20:42 MTDiscord <greenxenith> Yessir
20:43 MTDiscord <greenxenith> I can see the config button now
20:43 MTDiscord <wsor4035> ok, ill leave that to you
20:43 MTDiscord <josiah_wi> I made a pull request. Keeping it simple for now. I will look through later for more things I can do to be helpful.
20:43 MTDiscord <wsor4035> also add website url if you would
20:43 MTDiscord <greenxenith> The reason I ask is I like the Hugo layout and it also uses markdown as well as supports templating, which is what I wanted out of pandoc
20:44 MTDiscord <wsor4035> note that the templating requires you to turn on the unsafe markdown, so it doesnt strip it out
20:44 MTDiscord <wsor4035> so your basically wanting to use what i did here for minetest_docs?
20:45 MTDiscord <greenxenith> I am asking why they should even be separate
20:45 MTDiscord <greenxenith> The API reference should be a part of the dev wiki
20:45 MTDiscord <greenxenith> And the dev wiki should include the other stuff, like tutorials, examples, etc
20:46 MTDiscord <greenxenith> This is how most game engines document stuff
20:46 MTDiscord <rollerozxa> that's what I thought we could do
20:46 MTDiscord <wsor4035> what do you all think about wiki vs dev wiki?
20:47 MTDiscord <greenxenith> They should definitely be the same
20:48 MTDiscord <greenxenith> I recognize that there is some player-facing stuff on the wiki, but that is dwindling
20:48 MTDiscord <celeron55> For the record: I just tried to figure out who hosts doxy.minetest.net and came to the conclusion that I have no idea. In order to figure that out, I need to dig up pre-2016 private IRC logs and I don't have them on hand
20:48 MTDiscord <greenxenith> Also here's a counterpoint for my API ref argument: Keeping the API reference in the main repository makes it easy for engine contributors to update the API ref
20:48 MTDiscord <rollerozxa> shadowninja?
20:48 MTDiscord <greenxenith> Counterpoint counterpoint: We can reference the API reference from the dev repo probably
20:49 MTDiscord <celeron55> Could be
20:49 MTDiscord <wsor4035> merging https://github.com/minetest/dev.luanti.org/pull/11 in 10 minutes
20:50 MTDiscord <rollerozxa> I don't think lua_api.md should go anywhere as the main API reference, but all the supplementary documentation we may want to have should be on the dev wiki, while being able to link back to the reference as the source of truth
20:50 MTDiscord <wsor4035> this probably should be made into an issue, but im think ill do a conversion and pr to bring in whats useful on wiki.minetest.net, and then once thats done wiki.minetest.net can just be redirect to dev.luanti.org
20:50 MTDiscord <wsor4035> as a first step
20:50 MTDiscord <greenxenith> That is contrary to the entire goal of minetest_docs
20:51 MTDiscord <rollerozxa> we're talking about the dev wiki now
20:51 MTDiscord <greenxenith> Then you didnt quite interpret my question fully
20:51 MTDiscord <greenxenith> I am proposing that the dev "wiki" be the entire unified documentation for Luanti
20:52 MTDiscord <greenxenith> API refrence, supplementary documentation, examples, guidelines, etc
20:52 MTDiscord <wsor4035> perhaps, but i think one small step at a time
20:52 MTDiscord <wsor4035> i.e. merge wikis then pull minetest docs content in, then long, long term lua api to dev site or something
20:52 MTDiscord <greenxenith> I am asking now so any parallel work on the minetest_docs side is pointing in generally the right direction
20:54 MTDiscord <celeron55> I'd say, try to set both, a short term goal and a long term goal. The long term goal could be what Green is saying. Short term is more about the practicalities of today
20:54 MTDiscord <greenxenith> Actually I think further discussion is needed on the minetest_docs part anyway ... Mark and I were talking about the differences between the API reference and what contributors should be writing, as well as some in-code docs. I need to go re-read that discussion
20:55 MTDiscord <greenxenith> (later)
20:55 MTDiscord <wsor4035> any obvious objections to me making this issue?
20:55 MTDiscord <wsor4035> https://cdn.discordapp.com/attachments/926231483155378176/1317595851408805898/image.png?ex=675f4242&amp;is=675df0c2&amp;hm=ad0e6cf1c1dbdff5e171605569ac0cc5b0fde075f3d42c8867013c2cd1df5d04&amp;
20:55 MTDiscord <greenxenith> go for it
20:56 MTDiscord <rollerozxa> I assume we'd be throwing away the MTG stuff from the regular wiki?
20:56 MTDiscord <greenxenith> We could move it into the MTG repo
20:56 MTDiscord <greenxenith> That way the content isnt lost
20:56 MTDiscord <greenxenith> Luatic can figure out what to do with it :juanchi_face:
20:56 MTDiscord <wsor4035> @Josiah (Sie/Sie) not sure why you assigned yourself to that pr? just checking that its ready for review?
20:57 MTDiscord <celeron55> A big question is, whether it's worth it to have a minimal doc and an extended doc, where a code contribution always comes with the minimal doc update, or whether the minimal doc should simply be dropped altogether, in which case engine PRs would contain the minimal doc as non-committed metainformation which would then be edited into the extended docs by the docs team
20:57 MTDiscord <greenxenith> That is what my conversation with Mark covered, which I need to reread
20:58 MTDiscord <celeron55> Once there's an answer to that, the long term goal is pretty much set
20:58 MTDiscord <greenxenith> I will open an issue for that once I have words formulated
21:00 MTDiscord <celeron55> Versioning becomes quite important if there's no minimal doc in the engine repo. But it's not necessarily unmanageable
21:00 MTDiscord <wsor4035> green, since your probably the most applicable person. dunno if you want notifications in #github-feed for this repo, this irc channel, or whatever. personally dont care so nominating you for it 😛
21:00 MTDiscord <greenxenith> I wonder if I can tell github to only send updates once a day
21:03 MTDiscord <wsor4035> im going to add dependabot to the repo for the template
21:03 MTDiscord <wsor4035> objections?
21:04 MTDiscord <rollerozxa> sure
21:04 MTDiscord <greenxenith> I dont have perms for webhooks 😅
21:05 MTDiscord <greenxenith> Should we disable merge commits? We have them disabled on the blog, and it looks nicer
21:06 MTDiscord <wsor4035> sure, ive been squashing and merging so far
21:06 MTDiscord <greenxenith> Done
21:07 MTDiscord <wsor4035> just going to mention https://github.com/minetest/dev.luanti.org/issues/9 here for someone better at writing than I, else I will get to it later
21:07 MTDiscord <wsor4035> i aim to have https://github.com/minetest/dev.luanti.org/issues/8 done in a bit after i take care of a few irl things first
21:08 MTDiscord <greenxenith> Could I get some webhook perms, when you can?
21:08 MTDiscord <wsor4035> looks like i would have to make you an admin to do that?
21:11 MTDiscord <wsor4035> i suppose that probably is a good thing at the repo level, other than just me (obviously org admin people have access) to have more than me for bus factor/availability. does anyone have objections to me making green an admin? (it looks like i have rights to do that)
21:13 MTDiscord <josiah_wi> Habit from Apache. xD
21:13 MTDiscord <josiah_wi> I assign myself to indicate that the PR is currently my responsibility.
21:20 MTDiscord <wsor4035> done. cc @greenxenith
21:20 MTDiscord <wsor4035> https://cdn.discordapp.com/attachments/926231483155378176/1317602072887296102/image.png?ex=675f480e&amp;is=675df68e&amp;hm=94ef5468f6c098fa435dbfc52a240db43541a8d1630d89c251a27566afd6d0e7&amp;
21:23 MTDiscord <greenxenith> Awesome, thank you
21:26 MTDiscord <greenxenith> Webhook is active
21:36 MTDiscord <wsor4035> anyone want to read over https://github.com/minetest/dev.luanti.org/pull/13/files? its very boring
21:36 MTDiscord <wsor4035> otherwise will merge on the hour will say
21:36 MTDiscord <wsor4035> few small missed things from conversion, like a few backticks, and removing title from conversion
21:37 MTDiscord <greenxenith> Yikes, so many forum links for mods :]
21:41 MTDiscord <wsor4035> also sorry for making that branch on main repo. forgot to fork and change origin url
21:41 MTDiscord <greenxenith> No worries
21:41 MTDiscord <rollerozxa> saw two things I corrected, otherwise looks good
21:42 MTDiscord <greenxenith> You can mark my review as complete if you fixed it
21:42 MTDiscord <wsor4035> need to publish your review?
21:43 MTDiscord <greenxenith> Ah yeah, literally just had this same thing happen with rubenwardy on the blog
21:43 MTDiscord <greenxenith> Nevermind then
21:43 MTDiscord <wsor4035> nothing to see here
21:43 MTDiscord <wsor4035> https://cdn.discordapp.com/attachments/926231483155378176/1317607874033225788/image.png?ex=675f4d75&amp;is=675dfbf5&amp;hm=d1212ac24487038eb7125304778256fea0eec6022c1bec552f8cfa7bd3e07d19&amp;
21:43 MTDiscord <greenxenith> Curse GitHubs review interface
21:43 MTDiscord <wsor4035> ok, merging then
21:43 MTDiscord <greenxenith> >luanati
21:44 MTDiscord <greenxenith> :illuminati:
21:45 MTDiscord <greenxenith> Your grammarn't will be the death of us some day
21:45 MTDiscord <wsor4035> i still write minetest half the time since its what im used to
21:46 MTDiscord <greenxenith> We need an auto spellcheck/capitalizer for commit titles ;p
21:46 MTDiscord <wsor4035> you can only complain so much, since i did the leg work to get this plane off the ground 😛
21:46 MTDiscord <greenxenith> I know I know
21:46 MTDiscord <wsor4035> undercore v2 2030? :juanchi_face:
21:47 MTDiscord <wsor4035> or are we just saying that you killed it now, but just havent told anyone 😛
21:47 MTDiscord <greenxenith> I havent decided yet
21:55 MTDiscord <rollerozxa> how do I build this hugo site locally?
21:56 MTDiscord <wsor4035> get the latest release of hugo extended, clone repo, init and checkout submodules, and then run hugo server in the remote dir
21:56 MTDiscord <rollerozxa> ah submodules, right
21:56 MTDiscord <greenxenith> We have submodules?
21:56 MTDiscord <rollerozxa> yeah for the hugo theme
21:57 MTDiscord <greenxenith> Aha
21:57 MTDiscord <rollerozxa> I didn't clone it recursively so I was wondering why when I ran hugo it just rendered a bunch of RSS files 😆
21:57 MTDiscord <wsor4035> i really thought about somehow making fun or the submodules at home stupidness from the engine during irrlichtmt days
22:22 MTDiscord <wsor4035> update wuzzy master issue in minetest/minetest repo
22:22 MTDiscord <wsor4035> totally didnt forget to do that till now
22:24 MTDiscord <wsor4035> should do this https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-custom-404-page-for-your-github-pages-site
22:25 MTDiscord <wsor4035> so much garbage in https://wiki.luanti.org/index.php?title=Special:AllPages&amp;hideredirects=1
22:26 MTDiscord <rollerozxa> so true
22:26 MTDiscord <rollerozxa> are you going through it to make a list of what we should migrate over?
22:28 MTDiscord <wsor4035> https://tenor.com/view/its-a-ver-strong-maybe-bohdi-tulsa-king-s1e9-its-very-likely-gif-27419032
22:30 MTDiscord <rollerozxa> I'm currently going to make a PR to import the markdown converted version of the Setting up a server page from the voxelmanip wiki
22:31 MTDiscord <rollerozxa> have gone through and renamed occurrences of minetest to luanti in it
22:31 MTDiscord <rollerozxa> the current server page on the minetest wiki is in such a rough state with broken images and such that I'll probably be bold and point it to the dev wiki page once merged
22:31 MTDiscord <wsor4035> https://wiki.luanti.org/Distributing_Minetest_Games stares at roller
22:32 MTDiscord <rollerozxa> heh hello
22:32 MTDiscord <wsor4035> https://github.com/minetest/dev.luanti.org/issues/15
22:35 MTDiscord <wsor4035> good news is i dont think that we will have any conflicting pages (urls)
22:36 MTDiscord <greenxenith> Itll probably get restructured at some point anyway
22:36 MTDiscord <wsor4035> how are you supposed to redirect github pages anyways?
22:36 MTDiscord <greenxenith> HTML redirect
22:36 MTDiscord <wsor4035> meta tag?
22:36 MTDiscord <rollerozxa> I would hope hugo has the ability to generate redirect pages like jekyll does it?
22:37 MTDiscord <greenxenith> Which we should probably set up for pages we choose to cull
22:37 MTDiscord <greenxenith> (if they are moved, at least)
22:38 MTDiscord <greenxenith> I've set up some labels, btw
22:38 MTDiscord <rollerozxa> I'll go ahead and merge https://github.com/minetest/dev.luanti.org/pull/16 since it's an import, unless anyone objects
22:39 MTDiscord <greenxenith> :doit:
22:40 MTDiscord <wsor4035> isnt there a server page already?
22:40 MTDiscord <greenxenith> Can the minetest_to_luanti branch be deleted?
22:40 MTDiscord <wsor4035> yes
22:41 MTDiscord <greenxenith> What about init_hugo?
22:41 MTDiscord <wsor4035> sure
22:41 MTDiscord <rollerozxa> for setting up a server on the dev wiki?
22:41 MTDiscord <wsor4035> i thought one of the wikis had a server page of some sort already
22:42 MTDiscord <grorp> there's a bunch of lunati occurences
22:42 MTDiscord <grorp> https://github.com/search?q=repo%3Aminetest%2Fdev.luanti.org%20lunati&amp;type=code
22:42 MTDiscord <wsor4035> lovely
22:42 MTDiscord <greenxenith> Gee, I wonder why
22:43 MTDiscord <greenxenith> (Spellcheck actions exist btw)
22:43 MTDiscord <rollerozxa> yeah the regular wiki. it has broken images because the wiki thumbnailer is broken, and I would like it to be available at a better place
22:43 MTDiscord <wsor4035> make a pr to add one
22:44 MTDiscord <rollerozxa> (I'm also trying to clear out anything I am hoarding at the voxelmanip wiki)
22:44 MTDiscord <wsor4035> https://github.com/minetest/dev.luanti.org/pull/17/files hmm, i wish vscode replace would honor case
22:44 MTDiscord <greenxenith> With some fancy regex it can
22:45 MTDiscord <wsor4035> lol, i missed that there was pages. i need to go through the rest
22:46 MTDiscord <greenxenith> https://github.com/marketplace/actions/md-spellcheck-action or https://github.com/marketplace/actions/check-spelling should work fine
22:47 MTDiscord <greenxenith> @Josiah (Sie/Sie) I deleted your feat/better-thread-list-formatting branch as well since #10 was merged
22:48 MTDiscord <greenxenith> Future reference for everyone: Fork please:fork:😁
22:48 MTDiscord <josiah_wi> Oh, thank you, GreenXenith!
22:49 MTDiscord <wsor4035> https://github.com/minetest/dev.luanti.org/pull/17 someone please look at this
22:50 MTDiscord <wsor4035> 4 full pages of pure garbage on the normal wiki
22:51 MTDiscord <rollerozxa> and that is even after I nuked like a thousand pages a while back
22:54 MTDiscord <josiah_wi> Lunati, the game they play in asylums.
22:56 MTDiscord <greenxenith> Testing a new branch prevention rule
22:57 MTDiscord <rollerozxa> I'll also merge this import PR https://github.com/minetest/dev.luanti.org/pull/18 unless anyone objects
22:57 MTDiscord <wsor4035> going through the other three now
22:57 MTDiscord <wsor4035> works for me
23:02 MTDiscord <greenxenith> Branch protection seems to work
23:02 MTDiscord <greenxenith> In theory if anyone tries to push to a non-master branch it will fail
23:03 MTDiscord <wsor4035> https://github.com/minetest/dev.luanti.org/issues/15 has all pages worth potentially caring about on it
23:03 MTDiscord <wsor4035> please suggest ones to burn
23:04 MTDiscord <wsor4035> >93
23:04 MTDiscord <wsor4035> fuck
23:05 MTDiscord <rollerozxa> nice
23:05 MTDiscord <wsor4035> so, we should make https://wiki.luanti.org/Setting_up_a_server/Debian say 1. nuke debian 2. install a real distro 3. see /server :juanchi_face:
23:06 MTDiscord <rollerozxa> yeah I think we can drop that page lol
23:06 MTDiscord <greenxenith> Burn Griefing, How to build house, and Ores
23:06 MTDiscord <rollerozxa> the debian wiki has its own minetest page for how to set up a server their way
23:06 MTDiscord <wsor4035> im keeping it since we should redirect it if nothing else
23:06 MTDiscord <greenxenith> There are a lot of pages there that are half-relevant that should be improved or merged at some point but for now they are fine
23:07 MTDiscord <wsor4035> just edit the list and take those off
23:07 MTDiscord <rollerozxa> yeah I see
23:07 MTDiscord <wsor4035> hmm, once green is done editing, ill make two titles, one for move, one for redirect
23:08 MTDiscord <greenxenith> Done
23:08 MTDiscord <wsor4035> done

| Channels | #minetest-docs index | Today | | Google Search | Plaintext