Stupid Node Name Capitalization Convention

Post Reply
User avatar
Wuzzy
Member
Posts: 3938
Joined: Mon Sep 24, 2012 15:01
GitHub: Wuzzy2
IRC: Wuzzy
In-game: Wuzzy

Stupid Node Name Capitalization Convention

by Wuzzy » Post

Hi! I Have A Simple Suggestion To All Mod Makers (Including Those Of game_minetest).

Can We Please Stop The Convention To Write Every Single Word Capitalized In The Node Descriptions? I Think It Is A) Stupid B) Not Proper English Because It Looks Like These Were Proper Names But They Are Just Descriptions So It Is Wrong And C) It Looks Stupid When You Have To Write About These Nodes In The Wiki, Eg.
Clay can be found on sand beaches (underwater). They drop 4 Clay Lumps when mined.
Therefore I Want To Have Node Descriptions In Proper English, Eg. Instead Of Writing “Junglewood Slab” It Should Be Written “junglewood slab”.

I Already Started To Break This Annoying And Stupid Convention In My Mod “Geology”.

Do You Agree With The Suggestion?

User avatar
Bas080
Member
Posts: 398
Joined: Mon May 21, 2012 15:54
GitHub: bas080
IRC: bas080
In-game: bas080
Location: Netherlands

Re: Stupid Node Name Capitalization Convention

by Bas080 » Post

Agree, current mods i am working on use the proper conventions for capitalization. If i'm not sure then i'll make sure to google it.

EDIT: If first letter is always capitalized i think capitalization should be done by the core or some kind of cascading stylesheet. JK. Serious about the capitalization though.

User avatar
rubenwardy
Moderator
Posts: 6108
Joined: Tue Jun 12, 2012 18:11
GitHub: rubenwardy
IRC: rubenwardy
In-game: rubenwardy
Location: United Kingdom
Contact:

Re: Stupid Node Name Capitalization Convention

by rubenwardy » Post

They are titles. I think it should be like this. With the wiki, you don't need to put the caps

[[Iron Lumps||iron lumps]]

User avatar
HeroOfTheWinds
Member
Posts: 470
Joined: Wed Apr 23, 2014 23:16
GitHub: HeroOfTheWinds
IRC: WindHero
Location: Hawaii

Re: Stupid Node Name Capitalization Convention

by HeroOfTheWinds » Post

Just refer to everything by it's ItemString, lol.
default:iron_lump
Nam ex spatio, omnes res venire possunt.
Why let the ground limit you when you can reach for the sky?
Back to college now, yay for sophomore year schedules. :P

User avatar
philipbenr
Member
Posts: 1688
Joined: Fri Jun 14, 2013 01:56
GitHub: philipbenr
IRC: philipbenr
In-game: robinspi
Location: United States

Re: Stupid Node Name Capitalization Convention

by philipbenr » Post

yep. A agree.

User avatar
paramat
Developer
Posts: 3626
Joined: Sun Oct 28, 2012 00:05
GitHub: paramat
IRC: paramat
Location: UK

Re: Stupid Node Name Capitalization Convention

by paramat » Post

Agreed, i only do it because minetest game does, but its a bad convention ... i'll now change to one capital.

User avatar
Wuzzy
Member
Posts: 3938
Joined: Mon Sep 24, 2012 15:01
GitHub: Wuzzy2
IRC: Wuzzy
In-game: Wuzzy

Re: Stupid Node Name Capitalization Convention

by Wuzzy » Post

Mmmh, I may be okay with capitalizing the first letter only. However, stuff breaks if you use the description anywhere else than just for tooltips, eg. in the middle of a sentence. Therefore, I do not view the descriptions as titles. I view descriptions as descriptions. ;-)

User avatar
Casimir
Member
Posts: 1163
Joined: Fri Aug 03, 2012 16:59
GitHub: CasimirKaPazi

Re: Stupid Node Name Capitalization Convention

by Casimir » Post

So one capital or all minimal? If we change the convention we should agree on one standard, not to have two new competing ones.
Minecraft by the way is doing every word capital e.g. "Oak Wood".

User avatar
Wuzzy
Member
Posts: 3938
Joined: Mon Sep 24, 2012 15:01
GitHub: Wuzzy2
IRC: Wuzzy
In-game: Wuzzy

Re: Stupid Node Name Capitalization Convention

by Wuzzy » Post

Well, I clearly prefer the complete lower-case version and use only upper case if there is actually a proper name involved (eg. “Peter’s example node”). For titles and captions some code magic could be use to make the first letter capitalized again (assuming the English version of Minetest is used).

User avatar
Krock
Developer
Posts: 4510
Joined: Thu Oct 03, 2013 07:48
GitHub: SmallJoker
Location: Switzerland
Contact:

Re: Stupid Node Name Capitalization Convention

by Krock » Post

I Agree.
Caps In First Letter - All Other With Small Ones.
Look, I programmed a bug for you. >> Mod Search Engine << - Mods by Krock - DuckDuckGo mod search bang: !mtmod <keyword here>

User avatar
rubenwardy
Moderator
Posts: 6108
Joined: Tue Jun 12, 2012 18:11
GitHub: rubenwardy
IRC: rubenwardy
In-game: rubenwardy
Location: United Kingdom
Contact:

Re: Stupid Node Name Capitalization Convention

by rubenwardy » Post

I still like the current format in descriptions for captions. All lower case would irritate me almost as much as a missing close bracket. Just make it lower case for the wiki in paragraphs. Upper case for titles and tool tips.

User avatar
vqrulane
Member
Posts: 17
Joined: Thu Dec 13, 2012 16:33

Re: Stupid Node Name Capitalization Convention

by vqrulane » Post

I'vE gOt A bEtTeR sOlUtIoN!

User avatar
Don
Member
Posts: 1643
Joined: Sat May 17, 2014 18:40
GitHub: DonBatman
IRC: Batman
In-game: Batman

Re: Stupid Node Name Capitalization Convention

by Don » Post

I see the description as a title instead of a description. It does not describe the node it only names it in most cases. It is like book titles. Some words (eg. and, with, of) would be lower case but most words have first letter capitalized.
I like it this way but if we decide to have a standard I will support it even if it isn't what I want.
Many of my mods are now a part of Minetest-mods. A place where you know they are maintained!

A list of my mods can be found here

User avatar
Calinou
Moderator
Posts: 3162
Joined: Mon Aug 01, 2011 14:26
GitHub: Calinou
IRC: Calinou
In-game: Calinou
Location: Troyes, France
Contact:

Re: Stupid Node Name Capitalization Convention

by Calinou » Post

I agree with this, but my mods try to integrate the default game as well as possible.

Old versions used to use “Lump of clay” instead of “Clay Lump”, which I prefer too.

4aiman
Member
Posts: 1208
Joined: Mon Jul 30, 2012 05:47

Re: Stupid Node Name Capitalization Convention

by 4aiman » Post

TL;DR
Before imposing some new rules, make sure you've followed the old ones. Like licences and contributor's permit.


The actual opinion:
+ Spoiler

User avatar
Linuxdirk
Member
Posts: 2518
Joined: Wed Sep 17, 2014 11:21
In-game: Linuxdirk
Location: Germany
Contact:

Re: Stupid Node Name Capitalization Convention

by Linuxdirk » Post

Wuzzy wrote:Do You Agree With The Suggestion?
Not in general. The descriptions within the game should be seen as titles (mostly upper-case words). When referring to them in continuous text they should fit into that text (e.g. lower-case, conjugated if necessary, etc.).

… the wiki … Maybe create a template for all default items and nodes.

Code: Select all

It drops 4 {{default|iron_lump|iron lumps}}
And the wiki software generates “It drops 4 iron lumps” from that text where “iron lumps” is a link to http://wiki.minetest.com/wiki/Iron_lump and has a title="" attribute containing “default:iron_lump”.

It first sounds complicated, but it’s actually a pretty easy one-liner.

User avatar
rubenwardy
Moderator
Posts: 6108
Joined: Tue Jun 12, 2012 18:11
GitHub: rubenwardy
IRC: rubenwardy
In-game: rubenwardy
Location: United Kingdom
Contact:

Re: Stupid Node Name Capitalization Convention

by rubenwardy » Post

You are saying that this isn't hacky:

Code: Select all

if RUS then
    minetest.register_item({
         description = "russian text"
    })
else
    minetest.register_item({
         description = "english text"
    })
end
Basically hard coding languages, rather than allowing locale files?

I also don't understand your thread point. What are you talking about? The thread title, ie, [Mod], isn't a guideline, it is required for a mod to be in the release section. The owners of the forum and GitHub have the right to make rules and ban you or not accept pull requests if you don't follow them. (Except where the rules go against GPL, but that is nothing to do with code style.)
Forum Information and Guidelines wrote:Subject of topic must be in one of these formats
Notice the 'must'.

If you're talking about Minetest related projects, I agree the [] tags are unneeded, but I can't edit that topic.
EDIT: I asked a moderator to do it.

User avatar
Linuxdirk
Member
Posts: 2518
Joined: Wed Sep 17, 2014 11:21
In-game: Linuxdirk
Location: Germany
Contact:

Re: Stupid Node Name Capitalization Convention

by Linuxdirk » Post

rubenwardy wrote:You are saying that this isn't hacky:
No, this isn’t hacky. This is stupidity that can be used as example of how it shouldn't be done in Coding 101.

There is exactly only ONE proper solution how translations are realized, and this is using gettext.
rubenwardy wrote:What are you talking about?
As far as I understand it’s about naming conventions (has NOTHING to do with coding).

User avatar
Hybrid Dog
Member
Posts: 2748
Joined: Thu Nov 01, 2012 12:46
GitHub: HybridDog

by Hybrid Dog » Post

I think the Capitation of every word in descriptions is like the wielding a torch about water transparency bug just one of the features copied from the other game (mc), same for the flowers, a viola > 0.5m, and trees, taking a 1m³ trunk from a tree in less than 1min by bare hand, and more. l'll change the descriptions.

‮‪‮
‮‪‮
‮‪‮
‮‪‮
‮‪‮
‮‪‮
‮‪‮
‮‪‮
‮‪

Post Reply

Who is online

Users browsing this forum: No registered users and 4 guests