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&is=675debc9&hm=f70488c6c8aff603639a37534020d14aa1ad6acd0826adf5fd2988b38abd508d& |
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&is=675ded07&hm=eb6e3bce20b4878253c2b1ab6243b79f996399652859f501f4aa34c0bc78b6a7& |
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&is=675dedbd&hm=0c7eb6cae6e2e5f08b87b0a642f98b68a606b8977c2c436725766f1c72b86a26& |
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&is=675df0c2&hm=ad0e6cf1c1dbdff5e171605569ac0cc5b0fde075f3d42c8867013c2cd1df5d04& |
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&is=675df68e&hm=94ef5468f6c098fa435dbfc52a240db43541a8d1630d89c251a27566afd6d0e7& |
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&is=675dfbf5&hm=d1212ac24487038eb7125304778256fea0eec6022c1bec552f8cfa7bd3e07d19& |
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&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&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 |