Information for new users

Carol’s “Discourse Help” post

is not very helpful here. It says nothing about formatting code.

It starts with a link to About Discussions, or specifically the Python Discussions rather than the software itself. This is harmless but not really useful for new users.

There is a misnamed link to the Code of Conduct, which believe me, is in no way, shape or form a FAQ.

Then there are a bunch of UI hints, which are useful but irrelevant to the question of formatting posts properly or asking good questions.

There’s also confusion over the name: Discuss, Discussions or Discourse? Which is correct?

The answer about searching is poor:

“Discourse is perfectly searchable using Google”

Yeah okay, but how do I use Google to search Discourse? (Or Discuss, or whatever it is called. Not to be confused with Discord, which is completely different software.)

Although I have zero expectation that people will read it before posting, it would be nice to have a proper set of instructions for asking good questions, starting with right at the top how to format code. At least we could link to it when newbies post without reading it.

Moderators already have the ability to edit people’s posts. I hate hate hate that (anti-)feature. My words are my words, and are not for other people to change without my permission.

There is a fundamental problem with giving users the ability to edit their posts: you break the integrity of the question:answer format. There is a game people sometimes play on Reddit where they do this deliberately for humour, but to a lesser extent that happens any time people make significant edits to their posts.

Hypothetical example:

Homer asks “What’s wrong with my code? mylist = [45, 2, 6]; x = mylist.sorted() but x isn’t sorted in order.”

Bart replies: “Sorry, your code isn’t working for me, I get an AttributeError. If I fix it to use sort it works fine.”

Homer then silently edits his question instead of replying, changing the code to mylist = ['45', '2', '6']; x = sorted(mylist). Then Lisa gives him the answer to the edited question, and looks like a helpful and clever fellow, and poor Bart looks incompetent.

In a perfect world we could trust people to only edit their posts to fix minor typos and other inconsequential mistakes, and not to change the semantics of their posts.

Its not a great tragedy when this happens, but it is quite frustrating and annoying.

2 Likes