15

A current FAQ on How do I write a good title? seems ambiguous on whether titles that begin with “How do I ⟨do something⟩?” or “How to ⟨do something⟩?” are desirable on Stack Exchange sites generally, or whether a shorter title like “Doing ⟨something⟩” is to be preferred.

By ambiguous I mean things like the most upvoted answer saying:

4. Don't start with "How do I..."

Writing in that style ensures that your title will fail criteria 1-3, and get less attention than it deserves.

This is a question site, and people will understand your titles are questions.

while the FAQ title starts with:

"How do I..."

Without going into all other possible title structures, and individual sites may already have clarified this in their own Metas, is there generally a case for preferring one of the above over the others while performing more comprehensive editing of a question?

A similar question (Preferred title format: gerund or "how to"?) was asked long ago from what I suspect was a pure Stack Overflow perspective. It was made a duplicate of How do I write a good title? an hour and a bit later which, in retrospect, seems to have been hasty because unambiguous advice on this particular aspect is not offered in that FAQ.

4
  • 7
    Since "How do I" is discouraged, and "title" is a tag, that post should be retitled as "Write good".
    – user315433
    Commented Feb 22, 2018 at 1:27
  • @FTP I almost agree - but I think "Writing good titles?" would be better in this instance.
    – PolyGeo
    Commented Feb 22, 2018 at 1:29
  • 1
    I think FTP's comment is a tongue-in-cheek since it's deliberately referring to "don't put a tag in the title" (while it's not always the case) :p. Alternatively, the title can be changed to "Tips on writing good titles" without a question mark... or similar to that. Commented Feb 22, 2018 at 8:55
  • @HTTP I got the double entendre but it made an opening for me to say what I would write as a title for that FAQ.
    – PolyGeo
    Commented Feb 22, 2018 at 9:36

3 Answers 3

12

I think it looks cumbersome and repetitive to see the front page or any search for questions return a list of titles like:

  • How do I start a Python script?
  • How to update Blender?
  • How do I write a good question title?
  • How do I open an event?
  • How to innovate in Operations Research?

I find them quicker to read/scan when they are of the form:

  • Starting a Python script
  • Updating Blender
  • Writing a good question title
  • Opening an event
  • Innovating in Operations Research

I think that replacing "How do I …", etc by using "ing" (a gerund) instead is a typical way to construct titles in technical writing, and I see Stack Exchange sites as being a form of technical writing.

-2

Non-native speaker here.

First choice: How do I ...

On a question-answering site, ask questions as if you asked some people around you right away, since that is what lets you aim at an answer, and that is what makes the needed answer clearer at a first glimpse, and it is the way most people enter their search in a search engine.

You should not write "How to ...?", which is not 100-percent-proper English - see the remark under the question at "How to ... ?" questions might be wrong grammar. Will it help dropping the question mark for all questions or warning the user or something the like?:

It may not be 'proper' according to some, but it works.

Ask "How do I" / "How can I", which keeps it short and clear, and it is the main way how the people write down their search in the search engines.

Second and last choice (since Stack Exchange is not a blog): "How to ... [without a question mark]" / gerund

If your question builds up a frame of a sort of technical writing, perhaps a self-answered question, a guide or some code that needs to be checked, you may (but rather should not) switch to a blog-style "How to ..." (without a question mark at the end) or a gerund. Both aren't questions, they are a style of blogs or technical platforms. That is why they do not fit well enough to this question-answering site.

-8

On most sites, "how do I" questions are too large and vague for the site. "How do I build a house?" "How do I ski down a mountain?" "How to become a video game developer?". Quibbling about the wording of a fundamentally wrong question title is not useful.

Better questions are more precise and focused. "Why do I get this error message?" "What is this spiky leaved white flowered plant?" "Why do my questions have so few views compared to other people's on the same site?"

If you find yourself writing a title that might start "how do I", stop and think about what your actual answerable precise question is, and ask that instead.

4
  • 8
    I disagree with conflating "How do I"/"How to" questions with large/vague questions. e.g., "How to attach 1/4" thick plywood to 15/32" thick plywood at 90° and being able to remove and attach again?" is a very precise question. Conversely, "Why" and "What" questions can be too large and vague.
    – cigien
    Commented Mar 7 at 14:54
  • "Too large and vague for the site" - I have 156 StackOverflow questions which say differently, 19 questions on TeX.SX etc. I would say your statement is incorrect. Many how do I questions are vague and/or lacking in focus, but many others - aren't. Just one example: "How do I cite RFC documents in an academic paper?"
    – einpoklum
    Commented Mar 9 at 16:47
  • 4
    In my experience, Stack Overflow "how do I?" questions are more useful than "what's wrong with my code?" questions - because people can sometimes give a clear description of an atomic task (and recognize what's atomic), but almost never actually debug their code and produce a proper minimal reproducible example for the problem. Further, attempting to add code for an existing attempt to a "how do I?" question almost always makes it worse. (Code used to describe setup for the problem is fine, and so is code to verify a result, although the latter is fairly rare.) Commented Mar 10 at 2:17
  • @cigien I thought "How to attach ... again?" was not proper English, nor "How to become a video game developer?" Either without the question mark, or with a "How do I" at the beginning, but not "How to ...?", that is what some English native speaker told me somewhere. There is a discussion on this at "How to ... ?" questions might be wrong grammar. Will it help dropping the question mark for all questions or warning the user or something the like?. Commented Jul 2 at 8:13

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .