Luanti logo

IRC log for #minetest-docs, 2025-02-01

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

All times shown according to UTC.

Time Nick Message
00:22 MTDiscord <wsor4035> copper
00:22 MTDiscord <wsor4035> yeah, stripping down through this mtg stuff, im pretty sure none of it has any value
00:23 MTDiscord <wsor4035> not worth the effort of doing anything with, at best you will be left with a few sentences per item
00:24 MTDiscord <wsor4035> so anyone have any objection of taking option 1, nuking the mientest_game repo
02:42 MTDiscord <mark.wiemer> I'd nuke it and validate whatever basic backup we have for historical purposes. Heck, we can just send every page to archive.org and be done with it in my book
03:58 MTDiscord <wsor4035> i allowed dependabot to bypass branch rule so making prs would actually work
05:00 MTDiscord joined #minetest-docs
13:43 MTDiscord <rollerozxa> indeed
14:31 MTDiscord <wsor4035> If no one screams, say in 3 hours I'll just nuke that repo
15:06 MTDiscord <rollerozxa> do it ‼️
17:47 MTDiscord <wsor4035> gone
18:54 MTDiscord <mark.wiemer> We should manually update the links anyway, a lot of them point to wik.luanti.org/Page instead of just /page, right? Slashes at the end are kind of industry standard, may be unforeseen consequences of changing
18:56 MTDiscord <rollerozxa> this was about the MTG content
18:56 MTDiscord <rollerozxa> for the new docs pages we should obviously update the links to the new format
19:36 MTDiscord <wsor4035> would today work?
19:44 MTDiscord <wsor4035> merging https://github.com/luanti-org/dev.luanti.org/pull/162 in 5
19:51 MTDiscord <celeron55> Done
19:51 MTDiscord <celeron55> Now we can wait for the screaming to begin
19:52 MTDiscord <wsor4035> exports are here btw: https://github.com/rollerozxa/mt-wiki-dumping-ground/blob/master/raw-exports/Luanti%2BWiki-20241220214815.xml, we gave up o nthe mtg site because by the time you strip the crafting reciepes there isnt anything of value. also making the wiki text output good is rather intensive actually
19:55 MTDiscord <celeron55> I appreciate the executive summaries
20:10 MTDiscord <wsor4035> merging https://github.com/luanti-org/dev.luanti.org/pull/163 in 5
20:10 MTDiscord <wsor4035> fix one issue, open another in the process
20:11 MTDiscord <wsor4035> https://tenor.com/view/thanos-perfectlybalanced-gif-18301221
20:18 MTDiscord <rollerozxa> truly a momentous occasion to see the old wiki finally being buried
20:22 MTDiscord <wsor4035> two more things on the roadmap till i can nuke greenxeniths contribution
20:22 MTDiscord <wsor4035> well s/nuke/revert
20:25 MTDiscord <wsor4035> for 1/2 of those things, thinking of shoving all the server related stuff under /server, thoughts?
20:28 MTDiscord <wsor4035> fyi, i added a third issue to the short term: https://github.com/luanti-org/dev.luanti.org/issues/165
20:32 MTDiscord <wsor4035> roller: should database backends be under such a thing?
20:32 MTDiscord <rollerozxa> hmm
20:32 MTDiscord <rollerozxa> sounds fair enough
20:32 MTDiscord <wsor4035> i can see reasons why it shouldnt, but also only server admins are going to care probably?
20:32 MTDiscord <rollerozxa> yeah probably
20:32 MTDiscord <rollerozxa> I guess backup solutions can also be put under that directory
20:34 MTDiscord <rollerozxa> even though singleplayer players might end up reading the pages they would be doing so because they've put on the server maintainer hat and gone under the hood, most likely. so sounds good putting it under the directory
20:34 MTDiscord <rollerozxa> in the same vein I'll put all compilation guides we have here under a /compiling directory
20:35 MTDiscord <wsor4035> merging in https://github.com/luanti-org/dev.luanti.org/pull/166 in 5
20:36 MTDiscord <rollerozxa> could you move back the compiling headless server page
20:37 MTDiscord <rollerozxa> (I feel putting all of the compilation guides under its own directory sounds better. especially if we're gonna be starting to link them from the engine repo
20:38 MTDiscord <wsor4035> done
20:39 MTDiscord <rollerozxa> thx
20:39 MTDiscord <wsor4035> i assume your otherwise happy with that pr?
20:39 MTDiscord <rollerozxa> yeah looks good
20:40 MTDiscord <wsor4035> glances over at #luanti-irc maybe we need a terminology page
20:40 MTDiscord <wsor4035> then again, modifying that saying about americans users will always use anything but the actual term
20:42 MTDiscord <wsor4035> lel, there is old dev.minetest.net urls still in this content
20:47 MTDiscord <wsor4035> added some numbers to https://github.com/luanti-org/dev.luanti.org/issues/165
20:49 MTDiscord <rollerozxa> https://github.com/luanti-org/dev.luanti.org/pull/167
20:49 MTDiscord <rollerozxa> merging in 5m unless there are objections
20:49 MTDiscord <wsor4035> lgtm, ship it
20:56 MTDiscord <wsor4035> 16 files to stick in categories
20:57 MTDiscord <wsor4035> interesting, itemstring isnt on https://github.com/luanti-org/dev.luanti.org/issues/47, i was thinking of jamming the itemstring file in /docs
20:58 MTDiscord <mark.wiemer> We have a /docs folder? How is that different from the root of the site?
20:59 MTDiscord <rollerozxa> I had put the imported contents from minetest_docs there a while ago
20:59 MTDiscord <wsor4035> ...in the context of /contents....
21:00 MTDiscord <rollerozxa> now it maybe should be called /api since it's for the lua api
21:00 MTDiscord <mark.wiemer> I'm not at my pc right now. What files are in contents/docs? Why not just put them in contents or something more specific? The whole site is docs, so a subfolder named docs is confusing
21:00 MTDiscord <mark.wiemer> Yeah if it's for API name it /api
21:00 MTDiscord <rollerozxa> this ^ is why
21:00 MTDiscord <wsor4035> ||mobile reading is hard||
21:02 MTDiscord <wsor4035> have to add an alias to every page i suppose
21:02 MTDiscord <wsor4035> 🤷 go for it, just means we will get slightly more hate about having duplicate lua api content, but who cares
21:02 MTDiscord <mark.wiemer> I wouldn't go alias-crazy. Site is new, links will break, don't want to keep old URLs aliased if we do want to change them
21:03 MTDiscord <wsor4035> https://tenor.com/view/facedesk-gif-5907213
21:03 MTDiscord <mark.wiemer> Why would we? The hate is just as deserved as "there is a docs subfolder on the docs site but it's just dupe API docs"
21:03 MTDiscord <rollerozxa> yeah I think we could shed some aliases actually. only ones we really need are ones going from wiki.minetest.net and dev.minetest.net
21:04 MTDiscord <mark.wiemer> Note also that we have aliases for casing that we don't need. URLs are not case-sensitive for us, so aliasing /light to /Light does nothing
21:04 MTDiscord <rollerozxa> since when did github pages become case insensitive?
21:04 MTDiscord <wsor4035> its in the context of the old wiki having lua api related docs that where ancient, and some poeple dont want to see the same happen again. you mised the point
21:05 MTDiscord <wsor4035> this is false
21:05 MTDiscord <mark.wiemer> Easy to test
21:05 MTDiscord <wsor4035> https://docs.luanti.org/compiling/Linux-server/ does not go to https://docs.luanti.org/compiling/linux-server/ automatically, thus your point is moot
21:06 MTDiscord <mark.wiemer> Thanks for testing, sorry for being wrong
21:06 MTDiscord <wsor4035> do you have examples?
21:07 MTDiscord <rollerozxa> most of the ones from the voxelmanip wiki, which redirects to their proper new URLs
21:07 MTDiscord <rollerozxa> (I can go through those myself sometime)
21:08 MTDiscord <mark.wiemer> We should keep aliases that are in use. But I'm OK with breaking any bookmarks to dev.luanti.org/docs/abc, as dev is old and docs is a bad name. Asking those (few) folks to manually update to docs.luanti.org/api/abc seems very reasonable to me and saves us from vestigial aliases that will become a minor headache sometime in the future for reasons unknown
21:08 MTDiscord <rollerozxa> yeah. when we're this early on we can afford to break some new permalinks too. we have "URLs may change quickly without notice." after all in the banner
21:09 MTDiscord <mark.wiemer> Signing off to cook lunch
21:09 MTDiscord <wsor4035> eh, just break the /doc ones, if anyone screams we can add them in
21:10 MTDiscord <rollerozxa> I'll do the rename rq
21:11 MTDiscord <wsor4035> personally i think there is a chance they might be right. the minetest_docs project kinda died for various factors such as the terrible format, etc, but i havent really seen people in line to work on it even in the new project/format
21:11 MTDiscord <wsor4035> ||green says he will eventually do it, or did, but that might be in 2069||
21:12 MTDiscord <wsor4035> to be fair, we do have stuff relating to that in the roadmap, under the longerterm part
21:12 MTDiscord <rollerozxa> https://github.com/luanti-org/dev.luanti.org/pull/168
21:13 MTDiscord <rollerozxa> merging in 5m...
21:13 MTDiscord <wsor4035> ship it
21:13 MTDiscord <wsor4035> roller, want to handle updating the main page since wiki.* is merged in now?
21:13 MTDiscord <rollerozxa> oh, sure
21:15 MTDiscord <wsor4035> thoughts on other folders? maybe content-dev or something? could jam licensing, texture packs, dev tools?
21:16 MTDiscord <wsor4035> in writing that im kinda on the fence about the suggested folder name
21:17 MTDiscord <wsor4035> roller: remote media under server? they are going to be the only people that use it tbh
21:19 MTDiscord <rollerozxa> remote media under server sounds good
21:22 MTDiscord <wsor4035> roller: maybe you should move https://github.com/luanti-org/dev.luanti.org/blob/master/content/improving-build-times.md to your compiling folder?
21:22 MTDiscord <rollerozxa> good idea, I'll do that
21:23 MTDiscord <wsor4035> if no one has objections, ill do this in a bit, afk a few
21:23 MTDiscord <wsor4035> i found some more things
21:28 MTDiscord <rollerozxa> I'm sure the name & idea of that directory could grow on us 😄
21:32 MTDiscord <rollerozxa> yolo
21:33 MTDiscord <rollerozxa> okay I updated the redirects over on the voxelmanip wiki site and trimmed what should be all aliases that are from there
21:40 MTDiscord <wsor4035> interesting, i figured it has been just under a month since this started. its been almost two months now 🤔
21:43 MTDiscord <wsor4035> 4 years and a month if you count from the start of minetest_docs
21:43 MTDiscord <wsor4035> https://tenor.com/view/tom-hanks-sully-serious-gif-14124418
22:02 MTDiscord <rollerozxa> I also made a new post on the old wiki account request thread announcing the wiki's shutdown
22:03 MTDiscord <rollerozxa> maybe we should do some more announcements around the community to let people know about it now
22:03 MTDiscord <mark.wiemer> Hmm, I think we're kinda rushing through this organization phase. I won't stop you but I think taking time to create a full nested list of pages would make a better proposal in the long run. Small changes are usually good but this is a big-picture update and I worry we're not taking the time to structure things right, and that'll hurt us in the long run
22:04 MTDiscord <mark.wiemer> But yes, definitely we should make a forum announcement and/or Discord/IRC announcement asap
22:09 MTDiscord <wsor4035> i was planning 1.0 announcement, short term stuff done
22:09 MTDiscord <wsor4035> but not there for that yet
23:06 MTDiscord <celeron55> My thoughts about that are: I don't mind having a period of chaos with the docs, but eventually they should stabilize enough to warrant a forum post and why not a blog post too, and it's probably difficult to push that "eventually" very much into the future without having to make up excuses
23:08 MTDiscord <wsor4035> my idea was that https://github.com/luanti-org/dev.luanti.org/issues/113 short term section gets done, with whats remaining. basically * fix links (mark says he will do this) * mtg content removal (honestly could kick this to medium term) * categorization of stuff (simple) * remove beta banner at the top of the site
23:23 MTDiscord <wsor4035> merging https://github.com/luanti-org/dev.luanti.org/pull/169 in 5
23:28 MTDiscord <wsor4035> ok, so does anyone object to me moving mtg content removal over to medium term?
23:29 MTDiscord <wsor4035> if mark is able to do his links issue soon ™️ we probably could make an announcement eod tommorrow/eod monday

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