| Time |
Nick |
Message |
| 00:05 |
Shara |
Well, I don't mind you leading a docs team, but there isn't a team yet, just the potential for one. |
| 00:05 |
Shara |
I'd very much like to see there being one, and getting this channel up is a good start for that |
| 00:05 |
Shara |
But I've been working with people to improve documentation for quite a while now. |
| 00:06 |
jas_ |
mmm typos |
| 00:06 |
* jas_ |
is just glad loggingbot_ is here |
| 00:07 |
Shara |
It just seems silly to worry about who has what role until things are happening. |
| 00:09 |
Shara |
If the focus is editing wiki, Calinou's kind of automatically the leader anyway and should be making any decisions (I think?) |
| 00:11 |
Shara |
jas_: About auto_updates to the dev wiki, I'm not sure how that would be workable. |
| 00:12 |
Shara |
Level of detai on wiki is, I think, much more than on lua_api, or at least should be |
| 00:12 |
Shara |
detail* |
| 00:12 |
jas_ |
zdoom dev wiki would make a stub |
| 00:13 |
Shara |
If there is some way to automate anything so that there's better consistency, it's good |
| 00:13 |
jas_ |
automatically, so if a new minetest.register_on_modchannel_message(), or w/e, is added -- it makes a stub, gets the basics from lua_api.txt, and says, "expand this article further, it's a stub." |
| 00:13 |
jas_ |
pretty neat, not trivial and outside my expertise |
| 00:13 |
* Shara |
needs to get back to editing that soon |
| 00:14 |
jas_ |
but yes, i see the wiki articles have much better, more expanded info -- that's really good. it's just i always refer to lua_api.txt, because 1) it's canonical, and 2) it's up to date |
| 00:14 |
jas_ |
phew, it'll take a bit to kinda... audit the dev wiki |
| 00:14 |
jas_ |
i'm also curious about the separation between regular minetest wiki and dev wiki, but, i don't even have an acct yet; will wait for 2mrw after work |
| 00:14 |
Shara |
Personally I'd love to mak e aserious attempt at doing something with lua_api itself, because it's not really easy to work with. |
| 00:14 |
jas_ |
it's not, but it IS easy to link |
| 00:15 |
Shara |
But it's also... I think almost 4k lines long? |
| 00:15 |
jas_ |
right now, client_lua_api.md sucks because i can't link line numbers off github! :'( |
| 00:15 |
Shara |
So it would be a huge job to try anything meaningful with it |
| 00:15 |
jas_ |
i proposed in #minetest-docs, that there is a duplication client_lua_api.txt in addition to the markdown file; obv this isn't going to fly hehe |
| 00:15 |
jas_ |
how do you eat an elephant, Shara? : ) |
| 00:16 |
Shara |
Heh. |
| 00:17 |
Shara |
Smart :) |
| 00:18 |
Shara |
But personally I'd rather find a smaller meal. |
| 00:18 |
jas_ |
"one byte at a time" |
| 00:28 |
jas_ |
but that's my main interest here |
| 00:28 |
jas_ |
making sure the dev wiki at least has a stub for each item in lua_api.txt |
| 00:29 |
jas_ |
and like i was saying earlier bigfoot547, if you compare client_lua_api.mod to lua_api.txt, a lot of it will be the same |
| 00:30 |
jas_ |
so we can have one wiki article for, e.g. minetest.register_on_modchannel_message(), and simply mark it as both SSM and CSM |
| 00:30 |
jas_ |
it will have separate stubs, and be _categorized_ separately |
| 00:31 |
jas_ |
so you can go category:CSM or category:SSM and show only appropriate tagged articles |
| 00:31 |
jas_ |
i'm unfamiliar with the terminology here |
| 00:31 |
jas_ |
but have done some work on apps.linuxaudio.org years ago |
| 00:31 |
jas_ |
(like a lot lol) |
| 00:32 |
jas_ |
sounds good |
| 00:33 |
jas_ |
i haven't investigated the wikis much, always relied on lua_api.txt instead -- i tried the wiki in the beginning, but didn't take me long to realize it was out of sync with lua_api.txt |
| 00:34 |
jas_ |
so this is good, important work. i am hopeful for the dev wiki now. |
| 00:34 |
jas_ |
i always did want to help with at least filling the articles with pictures and examples |
| 00:34 |
jas_ |
should be fun |
| 00:36 |
Shara |
There are silly random pages on the wiki. Like people posting pages about the own servers and things. |
| 00:37 |
jas_ |
Shara: that's on the regular wiki? again, i'm uncertain the division between dev and regular minetest wikis |
| 00:37 |
Shara |
jas_: Yea. We talked about that a bit earlier, but I think it was before you got here |
| 00:37 |
jas_ |
in my mind,i always wondered why they were separate in the first place. but if there's mod pages, and server pages on regular wiki, that's good for at least posterity |
| 00:37 |
Shara |
bigfoot547: my thought too |
| 00:38 |
jas_ |
i'm really only interesting in dev wiki, to start. |
| 00:39 |
jas_ |
i noticed a lot of new modders work off the dev wiki, sometimes without knowing about lua_api.txt |
| 00:40 |
Shara |
A wiki is a lot more approachable :) |
| 00:45 |
jas_ |
i've got to go to work, but i wanted to leave this here for later: |
| 00:46 |
jas_ |
https://www.mediawiki.org/wiki/API:Main_page |
| 00:46 |
jas_ |
(i believe, this can be used with git hooks.) |
| 01:34 |
Shara |
It would make the topic kind of long. |
| 01:34 |
Shara |
Hmmm |
| 01:34 |
Shara |
rubenwardy: seems you declared yourself topic setter earlier, so thoughts? |
| 01:35 |
Shara |
I think it's a nice idea to have a central document to work from |
| 01:35 |
|
Topic for #minetest-doc is now Making better Minetest documentation | wiki.minetest.net | dev.minetest.net | http://dev.minetest.net/MinetestWiki:Worklist |
| 01:35 |
rubenwardy |
Sure |
| 01:35 |
rubenwardy |
you don't need to ask me though :) |
| 01:35 |
Shara |
I still like to get your thoughts :P |
| 02:11 |
|
Shara joined #minetest-doc |
| 09:47 |
Calinou |
hi :) |
| 09:48 |
Calinou |
jas_: check your email for the password of the wiki account, I created it as "Jas" (MediaWiki requires the first character to be uppercase) |
| 09:53 |
|
Krock joined #minetest-doc |
| 10:44 |
|
Krock joined #minetest-doc |
| 14:43 |
|
Krock joined #minetest-doc |
| 16:23 |
sofar |
are there folks here that can give out wiki access? |
| 16:24 |
sofar |
if not, then, fail? |
| 16:24 |
|
pigra_kojoto joined #minetest-doc |
| 16:24 |
pigra_kojoto |
hello all |
| 16:24 |
pigra_kojoto |
how to register in wikis? |
| 16:25 |
sofar |
afaik the forum is still the place to ask |
| 16:25 |
sofar |
I'm asking around to see if we can have folks in this channel also give out access |
| 16:33 |
|
pigra_kojoto1 joined #minetest-doc |
| 16:58 |
Shara |
sofar: Calinou usually handles it, and is here. |
| 16:59 |
Shara |
I don't even know if there is anyone else at all who can do it |
| 17:01 |
sofar |
kaeza? |
| 17:02 |
Shara |
No idea. |
| 17:09 |
|
Krock joined #minetest-doc |
| 18:09 |
|
pigra_kojoto joined #minetest-doc |
| 18:56 |
Calinou |
I'm not sure if I can promote people to administrator on wiki |
| 18:56 |
Calinou |
if I can, then you'll be able to create accounts for people :) |
| 18:56 |
Calinou |
(it's pretty easy) |
| 19:23 |
Shara |
Hmm, based on user list, only Calinou and c55 have admin access. |
| 19:23 |
Shara |
Not sure why I didn't just look earlier. |
| 19:31 |
pigra_kojoto |
Calinou: why not just add registration? |
| 20:24 |
|
Shara joined #minetest-doc |
| 23:45 |
jas_ |
so, it turns out dev.minetest.net wiki and wiki.minetest.net are two different names? |
| 23:46 |
jas_ |
i got my Jas account on wiki.minetest.net, but doesn't seem to work on dev.minetest.net |
| 23:46 |
jas_ |
i'm wondering what merit there is to separation |
| 23:47 |
Shara |
jas_: yes, you need to be registered on each seperately. |
| 23:47 |
jas_ |
ok |
| 23:48 |
Shara |
And I still don't really have an answer for why there's two wikis. |
| 23:49 |
jas_ |
*grin* |
