| Time |
Nick |
Message |
| 04:00 |
|
MTDiscord joined #luanti-docs |
| 13:35 |
|
user333_ joined #luanti-docs |
| 15:37 |
MTDiscord |
<wsor4035> @luatic big giant poke on https://github.com/luanti-org/docs.luanti.org/pull/343 |
| 16:16 |
MTDiscord |
<luatic> merged |
| 16:58 |
MTDiscord |
<wsor4035> @rollerozxa thoughts on if it would be worth building/pulling lua_api.md (https://api.luanti.org/) in its nice rendered/broke up form into docs project? that does however mean the question of what to do with orginal minetest docs stuff |
| 16:59 |
MTDiscord |
<wsor4035> (context https://github.com/luanti-org/docs.luanti.org/commit/ce704eebb4d086dfdc09104ab594949db164ecb9 disclaiming lua_api.md) |
| 17:01 |
MTDiscord |
<wsor4035> mostly since users have been reading up on our documentation than showing up here asking more, etc |
| 17:01 |
MTDiscord |
<rollerozxa> not sure. yes, I suppose? |
| 17:04 |
MTDiscord |
<rollerozxa> I would like to see the nice documentation we wrote for minetest_docs to not just disappear though. but don't really know what to do since lua_api.md remains the canonical reference |
| 17:04 |
MTDiscord |
<wsor4035> i mean, could try and polly patch over specific methods, but...... |
| 17:06 |
MTDiscord |
<rollerozxa> ideally we would try to push to split up lua_api.md in luanti docs and freshen it up with proper links to different sections, admonitions, etc... but that would be a big thing to push for and it's not something I personally find worth it enough |
| 17:07 |
MTDiscord |
<wsor4035> (always exists trying to get it merged into the engine, but i dont really have the energy to deal with that and/or wait 4 years) |
| 17:07 |
MTDiscord |
<rollerozxa> yeah |
| 17:07 |
MTDiscord |
<luatic> let's also see what Mark is cooking |
| 17:07 |
MTDiscord |
<luatic> because that is really where we want to go |
| 17:07 |
MTDiscord |
<wsor4035> the web fetch short code exists mainly so i didnt have to deal with engine stupidity 😛 |
| 17:07 |
MTDiscord |
<luatic> proper interlinked documentation with types and everything |
| 17:08 |
MTDiscord |
<rollerozxa> ooo |
| 17:08 |
MTDiscord |
<luatic> and i think it might be surprisingly feasible to let a LLM rewrite lua_api.md in such a format to get us 95% there |
| 17:08 |
MTDiscord |
<wsor4035> sure, but i have as much faith in that as sscsm, new gui framework, etc. if it succeds would be very happy, but also in short term it shouldnt block progress if we can do reasonable things |
| 17:10 |
MTDiscord |
<rollerozxa> I've been away from this docs project for a long time now, but I've done some contributions to SDL since then and fallen in love with their way of doing documentation |
| 17:10 |
MTDiscord |
<wsor4035> which is? |
| 17:11 |
MTDiscord |
<rollerozxa> the wiki pages are populated by and synced from their C headers in the SDL repo, while wiki editors can add additional sections that stay on the wiki side. all of it syncs up nicely both ways and there is a web interface that allows you to edit the wiki like you'd expect while it creates PRs on the wiki repo on github in the backend. then they have README docs files for various things that exist in the SDL repo while also being |
| 17:11 |
MTDiscord |
synced to the wiki so they have a permalink outside of github |
| 17:12 |
MTDiscord |
<wsor4035> interesting. works nicely if you don't have to wait 4 years i assume |
| 17:14 |
MTDiscord |
<rollerozxa> yup. in general a very easy and accessible project to contribute to and feel nice about it. probably caused by both maintainers (sam lantinga and ryan gordon) being AFAIK paid to work on it... |
| 17:15 |
MTDiscord |
<wsor4035> switching gears to #contentdb stuff, current contentdb page is under about. not sure it makes sense to put a faq under that (and maybe cdbs other documentation) |
| 17:16 |
MTDiscord |
<wsor4035> then again we do have history with two rando things under it |
| 17:16 |
MTDiscord |
<wsor4035> which really is more of an arguement against than anything |
| 17:17 |
MTDiscord |
<rollerozxa> c55's page is a very important part of the docs 8) |
| 17:17 |
MTDiscord |
<rollerozxa> "(no longer online)", "(no longer online)", "(no longer online)", "(no longer online)", oh well... |
| 17:18 |
MTDiscord |
<wsor4035> it makes sense for cdb to be headlined in about, but then again with more docs, it would make sense to be under for creators |
| 17:18 |
MTDiscord |
<wsor4035> i mean, could....... have it in both places and rel canocial to the other, but seems subpar |
| 17:19 |
MTDiscord |
<wsor4035> not to mention the about would have to link to the other |
