Channel description improvements 2. #121

Megaf · 2018-03-07T21:07:10Z

Making all channels match code style and text formatting.
Adding a more direct and clear description to each channel.
Making use of uppercase for aesthetics and to make things more relevant.
Adding webchat for Minetest-Hub. In the topic of the channel we have a link for the channels website and it also says about voice and asking an op for it.
Adding webchat for Minetest-Hub. Mainly to match style.

Opinions needed.

Making all channels match code style and text formatting. Adding a more direct and clear description to each channel. Making use of uppercase for aesthetics and to make things more relevant. Adding webchat for Minetest-Hub. In the topic of the channel we have a link for the channels website and it also says about voice and asking an op for it. Adding webchat for Minetest-Hub. Mainly to match style. Opinions needed.

Ezhh · 2018-03-07T21:18:41Z

irc.html

-      See <a href="http://hub.minetest.net/info">the channel's website</a> for more information.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-hub">#Minetest-Hub</a></strong>
+        (<a href="http://irc.minetest.net/minetest-hub">Logs</a>):
+        Community channel, to talk about modding, server adminitration and short off-topic.


The channel is not for offtopic; it's simply something we usually accept. I prefer the previous description for -hub, then adjust the other two so they are full sentences.

And what about the description for the other channels?

Ezhh · 2018-03-07T21:35:53Z

@Megaf You are pretty close already. #minetest needs a better description than we started with. Maybe instead of:
Main channel, where players can join to chat and get support about Minetest.
try:
Main channel where all players and contributors can discuss the game or request support.
(This is more inclusive, so I think it would be better.)

And for -dev, I'd suggest not replacing the current information (unless you can maybe think of a better term than "serious stuff"), but do fix the capitalisation ("development channel" to "Development channel") so it matches the others.

Reverting Minetest-Hub description. Improvements on Minetest description. TODO on -Dev, we have to rephrase serious stuff.

Updated Minetest-Dev description.

sofar · 2018-03-08T23:21:25Z

lgtm

sfan5 · 2018-03-09T15:28:47Z

irc.html

-      </strong>
-      (<a href="http://irc.minetest.net/minetest-dev">logs</a>):
-      development channel, only serious stuff; note that webchat is muted due to too much spam/flood.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-dev">#Mminetest-Dev</a></strong>


sfan5 · 2018-03-09T15:30:03Z

irc.html

-      (<a href="http://irc.minetest.net/minetest">logs</a>): main channel
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest">#Minetest</a></strong>
+        (<a href="http://irc.minetest.net/minetest">Logs</a>):
+        Main channel where all players and contributors can discuss the game or request support.


why explicitly name which group of people this channel for?

It was something we came with when discussing about it on #-dev. Do you have other suggestions?

sfan5 · 2018-03-09T15:30:26Z

irc.html

-      development channel, only serious stuff; note that webchat is muted due to too much spam/flood.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-dev">#Mminetest-Dev</a></strong>
+        (<a href="http://irc.minetest.net/minetest-dev">Logs</a>):
+        "Development channel, strictly engine or minetest_game development talk only; note that webchat is muted due to too much spam/flood."


quotes not needed

sfan5 · 2018-03-09T15:30:50Z

irc.html

-      (<a href="http://irc.minetest.net/minetest-hub">logs</a>):
-      A moderated channel for people who regularly improve Minetest by developing, modding, hosting servers and otherwise.
-      See <a href="http://hub.minetest.net/info">the channel's website</a> for more information.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-hub">#Minetest-Hub</a></strong>


why is the channel name capitalized?
this does not reflect their actual names on IRC

Because Minetest is capitalised and on IRC is up to the IRC client and/or user to "decide" how to represent it. Besides, in my opinion it looks better and more serious when capitalised.

It's lower case on the official page: http://hub.minetest.net/info
So it needs to be lower case here.

Only lowercase makes sense, that is specifically the channel name.

in case it matters: the IRC specification does not mention channel names being case-insensitive, so #minetest and #Minetest might in theory be totally different channels

Megaf · 2018-03-09T15:58:57Z

irc.html

-      (<a href="http://irc.minetest.net/minetest">logs</a>): main channel
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest">#Minetest</a></strong>
+        (<a href="http://irc.minetest.net/minetest">Logs</a>):
+        Main channel where everyone is welcome to discuss the game or request support.


Is this description any better?

Might change it to "Main channel for general game and engine discussion or support" in the next commit tho.

Remember MT is not a 'game', better to refer to 'Minetest engine' and 'games' (plural) as other games can be discussed.

I agree that 'everyone is welcome' is not needed.

paramat · 2018-03-09T19:09:02Z

irc.html

-      development channel, only serious stuff; note that webchat is muted due to too much spam/flood.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-dev">#Minetest-Dev</a></strong>
+        (<a href="http://irc.minetest.net/minetest-dev">Logs</a>):
+        Development channel, strictly engine or minetest_game development talk only; note that webchat is muted due to too much spam/flood.


Line too long in code, can it be split? I assume it auto-wraps when displayed on the webpage.

A web browser will indeed auto-wrap, so I wouldn't worry much about long line.

I mean, long line is best avoided in the code, if possible.

@paramat Better? And at least least nothing changed visually on Safari, just the editing in a console window gets easier with the line break indeed.

paramat · 2018-03-09T19:10:43Z

irc.html

-      See <a href="http://hub.minetest.net/info">the channel's website</a> for more information.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-hub">#Minetest-Hub</a></strong>
+        (<a href="http://irc.minetest.net/minetest-hub">Logs</a>):
+        A moderated channel for people who regularly improve Minetest by developing, modding, hosting servers and otherwise.


As above, if possible split long line in code.

Decapitalised channel names. Change in #minetest description.

I broke the line so they we can see the whole line in a standard terminal window using a text editor like nano or vi.

.

Megaf · 2018-03-10T12:30:52Z

So, what about we keep the link to web chats and add a note like so.

<div>
  <p>
    Join one of our <abbr title="Internet Relay Chat">IRC</abbr> channels on Freenode:<br/>
    Please note that in order to chat on #minetest-hub you need to
    ask an operator for voice and to chat on #minetest-dev you 
    need to be using a real IRC client.<br>
  </p>
  <ul>
    <li>
      <strong><a href="https://webchat.freenode.net/?channels=#minetest">#minetest</a></strong>
        (<a href="http://irc.minetest.net/minetest">Logs</a>):
        Main channel for general Minetest engine and games discussion or
        support.
    </li>
    
    <li>
      <strong><a href="https://webchat.freenode.net/?channels=#minetest-dev">#minetest-dev</a></strong>
        (<a href="http://irc.minetest.net/minetest-dev">Logs</a>):
        Development channel, strictly engine or minetest_game development
        talk only.
    </li>
    
    <li>
      <strong><a href="https://webchat.freenode.net/?channels=#minetest-hub">#minetest-hub</a></strong>
        (<a href="http://irc.minetest.net/minetest-hub">Logs</a>):
        A moderated channel for people who regularly improve Minetest
        by developing, modding, hosting servers and otherwise.
    </li>
  </ul>
</div>

Added a short notice about how to chat on -hub and -dev before the list of channels. Keeping web chat links

paramat · 2018-03-12T17:14:51Z

irc.html

-      development channel, only serious stuff; note that webchat is muted due to too much spam/flood.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-dev">#minetest-dev</a></strong>
+        (<a href="http://irc.minetest.net/minetest-dev">Logs</a>):
+        Development channel, strictly engine or minetest_game development


Maybe 'Minetest engine' here for consistency with the above?

or

strictly for discussions of <a href="https://github.com/minetest">official projects'</a> development

paramat · 2018-03-12T17:15:43Z

irc.html

  <p>
    Join one of our <abbr title="Internet Relay Chat">IRC</abbr> channels on Freenode:<br/>
+    Please note that in order to chat on #minetest-hub you need to
+    ask an operator for voice and to chat on #minetest-dev you 


Long sentence, perhaps:
ask an operator for voice, to chat on #minetest-dev you
?

paramat · 2018-03-12T17:17:22Z

Fine apart from my line comments.

sfan5 · 2018-03-12T19:50:05Z

irc.html

    Join one of our <abbr title="Internet Relay Chat">IRC</abbr> channels on Freenode:<br/>
+    Please note that in order to chat on #minetest-hub you need to
+    ask an operator for voice and to chat on #minetest-dev you 
+    need to be using a real IRC client.<br>


instead of saying "you need a real irc client" just say that you "can't use webchat on -dev"

<p> Join one of our <abbr title="Internet Relay Chat">IRC</abbr> channels on Freenode:<br/> To chat on #minetest-hub you need to ask an operator for voice. You can't you the webchat on #minetest-dev.<br> </p>

Good?

s/can't you/can't use/
yes

paramat · 2018-03-12T21:20:12Z

irc.html

 <div>
  <p>
    Join one of our <abbr title="Internet Relay Chat">IRC</abbr> channels on Freenode:<br/>
+    To chat on #minetest-hub you need to ask an operator for voice. You can't use the webchat on #minetest-dev.<br>


You can't use webchat on #minetest-dev
No need for 'the'

paramat · 2018-03-12T21:22:02Z

irc.html

      <strong><a href="https://webchat.freenode.net/?channels=#minetest">#minetest</a></strong>
-      (<a href="http://irc.minetest.net/minetest">logs</a>): main channel
+        (<a href="http://irc.minetest.net/minetest">Logs</a>):
+        Main channel for general Minetest engine and games discussion or


Almost suggests modding can't be discussed here.
Main channel for general Minetest engine, modding and games discussion or support.

paramat · 2018-03-12T21:27:21Z

irc.html

+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-dev">#minetest-dev</a></strong>
+        (<a href="http://irc.minetest.net/minetest-dev">Logs</a>):
+        Development channel, strictly for discussions of <a href="https://github.com/minetest">official projects'</a> development.
+        talk only.


Makes no sense.
strictly only for discussions of <a href="https://github.com/minetest">official projects'</a> development.

paramat · 2018-03-12T21:44:56Z

irc.html

-      development channel, only serious stuff; note that webchat is muted due to too much spam/flood.
+      <strong><a href="https://webchat.freenode.net/?channels=#minetest-dev">#minetest-dev</a></strong>
+        (<a href="http://irc.minetest.net/minetest-dev">Logs</a>):
+        Development channel, strictly only for discussions of <a href="https://github.com/minetest">official projects'</a> development.


Hmm actually, linking to the homepage and calling that 'official projects' isn't descriptive, the home page doesn't have an 'official projects' section and what is official isn't obvious.
How about no link and describing what can be discussed (MTEngine, MTGame), as before?

What was the old description again? Will see if I can find it easily

`..., strictly only for development discussion of the Minetest engine and Minetest Game'
'discussion' doesn't need to be plural.

So, what about one of the description that we came with before.

Development channel, for topics related to bug reporting and general Minetest development.

Megaf · 2018-03-12T21:45:07Z

I think I have addressed everything by now.
Anything else?

paramat · 2018-03-12T21:53:17Z

irc.html

 <div>
  <p>
    Join one of our <abbr title="Internet Relay Chat">IRC</abbr> channels on Freenode:<br/>
+    To chat on #minetest-hub you need to ask an operator for voice. You can't use webchat on #minetest-dev.<br>


Just one small thing, i think this sounds better, as a native English speaker:
Webchat cannot be used on #minetest-dev.

All else is fine for me.

Fantastic, I agree.

Megaf · 2018-03-12T21:55:12Z

Done.

paramat · 2018-03-12T22:07:34Z

👍 Text is ok for me.

Ezhh · 2018-03-13T18:21:45Z

Fine by me 👍

Ezhh reviewed Mar 7, 2018

View reviewed changes

Megaf added 2 commits March 7, 2018 21:55

Update irc.html

8ec97f6

Reverting Minetest-Hub description. Improvements on Minetest description. TODO on -Dev, we have to rephrase serious stuff.

Updated Minetest-Dev description.

3f02d00

Updated Minetest-Dev description.

Megaf changed the title ~~[WIP] Channel description improvements 2.~~ Channel description improvements 2. Mar 7, 2018

sfan5 reviewed Mar 9, 2018

View reviewed changes

Megaf added 2 commits March 9, 2018 15:42

Fixing typos

ecc001c

Update #Minetest description.

46fd050

Megaf commented Mar 9, 2018

View reviewed changes

paramat reviewed Mar 9, 2018

View reviewed changes

Megaf added 2 commits March 9, 2018 23:45

Update channel descriptions.

8dcd5e4

Decapitalised channel names. Change in #minetest description.

Added line breaks in the code.

67aa0aa

I broke the line so they we can see the whole line in a standard terminal window using a text editor like nano or vi.

Line breaks and short notice about web chat.

c04e09d

Added a short notice about how to chat on -hub and -dev before the list of channels. Keeping web chat links

paramat reviewed Mar 12, 2018

View reviewed changes

Megaf added 2 commits March 12, 2018 17:24

Shortening of voice notice and -dev web chat thing.

229fb17

Update #minetest-dev description,

261cd1e

sfan5 reviewed Mar 12, 2018

View reviewed changes

sfan5 approved these changes Mar 12, 2018

View reviewed changes

Shortening of descriptions.

691d8fe

paramat reviewed Mar 12, 2018

View reviewed changes

Updating descriptions, removing lines.

1c67481

paramat reviewed Mar 12, 2018

View reviewed changes

Updating #Minetest-Dev description.

69a1560

paramat reviewed Mar 12, 2018

View reviewed changes

Again.

6b437b6

rubenwardy merged commit 79a98b5 into luanti-org:master Mar 13, 2018

Megaf deleted the patch-1 branch March 13, 2018 22:31

Channel description improvements 2. #121

Channel description improvements 2. #121

Uh oh!

Conversation

Megaf commented Mar 7, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Ezhh commented Mar 7, 2018

Uh oh!

sofar commented Mar 8, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Megaf Mar 9, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

paramat Mar 9, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

paramat Mar 9, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Megaf commented Mar 10, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rubenwardy Mar 12, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

paramat commented Mar 12, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Megaf Mar 9, 2018 •

edited

Loading

paramat Mar 9, 2018 •

edited

Loading

paramat Mar 9, 2018 •

edited

Loading

rubenwardy Mar 12, 2018 •

edited

Loading

paramat Mar 12, 2018 •

edited

Loading

paramat Mar 12, 2018 •

edited

Loading