Difference between revisions of "Talk:Main Page"

From Minetest Developer Wiki
Jump to navigation Jump to search
(Created page with "== More mod pages == Can you please add the following pages to the mod section to make them more visible in the wiki?: * Mod interoperability * Groups --~~~~")
 
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== More mod pages ==
+
== [DONE] More mod pages ==
 
Can you please add the following pages to the mod section to make them more visible in the wiki?:
 
Can you please add the following pages to the mod section to make them more visible in the wiki?:
 
* [[Mod interoperability]]
 
* [[Mod interoperability]]
Line 5: Line 5:
  
 
--[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 10:18, 3 August 2016 (UTC)
 
--[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 10:18, 3 August 2016 (UTC)
 +
:Done --[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 21:00, 26 June 2020 (UTC)
 +
 +
== Delete stuff redundant to lua_api.txt ==
 +
A huge chunk of this wiki is just repeating lua_api.txt. This is pointlessly redundant and inconsistent. Users are fooled into thinking this wiki might be official documentation.
 +
 +
I propose to delete all pages which only contain information aready explained in depth in lua_api.txt. Who agrees?
 +
 +
What can stay IMO is everything which is supplemental. --[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 22:25, 2 June 2018 (UTC)
 +
 +
: I redirected myself to lua_api.txt after reading your message. I find it really painful to navigate but it is indeed more complete. As you wrote I thought dev.minetest.net was an official documentation.
 +
: An other disadvantage is that it cannot be changed that easily when something is missing or unclear, you have to go through the whole commit and merge things.
 +
: But on the other side it is embedded in the project and can be more consistent on releases and WIP versions (not messing about which version does the wiki page refer to). And mods can follow the same documentation scheme.
 +
: I thought about documentation generators to have nice html pages but I find it a bad good idea. It requires more tools that modders probably won't use, makes the actual code explode in size and functions are spread in builtin and games and mods etc)
 +
: I'm for redirecting to lua_api (or other doc files) when the doc is already there to avoid duplicates. The file could be enhanced but that's not the topic here.
 +
: If the choice is to open tickets to suggest documentation changes, the page could be completely deleted to make clear this wiki is not about documenting functions and objects.
 +
: --[[User:Karamel|Karamel]] ([[User talk:Karamel|talk]]) 10:50, 11 June 2018 (UTC)
 +
: Major update! [[User:rubenwardy]] and [[User:Zughy]] have deleted a huge portion of pages. https://forum.minetest.net/viewtopic.php?p=413997#p413997 There are still a few pages remaining because they contain "salvageable examples". See here: [[Category:Proposed_for_deletion]] --[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 08:39, 21 August 2022 (UTC)
 +
 +
== [DONE] Minetest is not a game ==
 +
 +
The introduction says that Minetest is a game, but that's not true. It should say Minetest is a game engine. --[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 10:19, 26 June 2020 (UTC)
 +
:Done. --[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 18:16, 26 June 2020 (UTC)
 +
 +
== [TODO] Fix the source code syntax highlighting issues. ==
 +
 +
It seems that all the source codes contained in wiki pages are broken. All of them are enclosed by <syntaxhighlight> or <source> tags.
 +
 +
All of them should be rendered as the following picture shows
 +
 +
[https://s3.bmp.ovh/imgs/2022/03/bef46585369211a5.png Good rendering source code snippet example]
 +
 +
But they are rendered as plain HTML texts
 +
 +
[https://s3.bmp.ovh/imgs/2022/03/bbc9bced169a7d1f.png Bad rendering source code snippet example]
 +
 +
It relys on a MediaWiki extension named [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight SyntaxHighlight],
 +
and the extension may have not been installed or is already broken.
 +
 +
Can the administrator of this wiki install or reinstall this extension?
 +
 +
== File upload broken ==
 +
 +
I can no longer upload files. I get an error message telling me the server is misconfigured. --[[User:Wuzzy|Wuzzy]] ([[User talk:Wuzzy|talk]]) 11:14, 6 June 2022 (UTC)

Latest revision as of 08:39, 21 August 2022

[DONE] More mod pages

Can you please add the following pages to the mod section to make them more visible in the wiki?:

--Wuzzy (talk) 10:18, 3 August 2016 (UTC)

Done --Wuzzy (talk) 21:00, 26 June 2020 (UTC)

Delete stuff redundant to lua_api.txt

A huge chunk of this wiki is just repeating lua_api.txt. This is pointlessly redundant and inconsistent. Users are fooled into thinking this wiki might be official documentation.

I propose to delete all pages which only contain information aready explained in depth in lua_api.txt. Who agrees?

What can stay IMO is everything which is supplemental. --Wuzzy (talk) 22:25, 2 June 2018 (UTC)

I redirected myself to lua_api.txt after reading your message. I find it really painful to navigate but it is indeed more complete. As you wrote I thought dev.minetest.net was an official documentation.
An other disadvantage is that it cannot be changed that easily when something is missing or unclear, you have to go through the whole commit and merge things.
But on the other side it is embedded in the project and can be more consistent on releases and WIP versions (not messing about which version does the wiki page refer to). And mods can follow the same documentation scheme.
I thought about documentation generators to have nice html pages but I find it a bad good idea. It requires more tools that modders probably won't use, makes the actual code explode in size and functions are spread in builtin and games and mods etc)
I'm for redirecting to lua_api (or other doc files) when the doc is already there to avoid duplicates. The file could be enhanced but that's not the topic here.
If the choice is to open tickets to suggest documentation changes, the page could be completely deleted to make clear this wiki is not about documenting functions and objects.
--Karamel (talk) 10:50, 11 June 2018 (UTC)
Major update! User:rubenwardy and User:Zughy have deleted a huge portion of pages. https://forum.minetest.net/viewtopic.php?p=413997#p413997 There are still a few pages remaining because they contain "salvageable examples". See here: --Wuzzy (talk) 08:39, 21 August 2022 (UTC)

[DONE] Minetest is not a game

The introduction says that Minetest is a game, but that's not true. It should say Minetest is a game engine. --Wuzzy (talk) 10:19, 26 June 2020 (UTC)

Done. --Wuzzy (talk) 18:16, 26 June 2020 (UTC)

[TODO] Fix the source code syntax highlighting issues.

It seems that all the source codes contained in wiki pages are broken. All of them are enclosed by <syntaxhighlight> or <source> tags.

All of them should be rendered as the following picture shows

Good rendering source code snippet example

But they are rendered as plain HTML texts

Bad rendering source code snippet example

It relys on a MediaWiki extension named SyntaxHighlight, and the extension may have not been installed or is already broken.

Can the administrator of this wiki install or reinstall this extension?

File upload broken

I can no longer upload files. I get an error message telling me the server is misconfigured. --Wuzzy (talk) 11:14, 6 June 2022 (UTC)