Tips for posting in the Wrox Forums
I am an active contributor to the Wrox P2P forums, where I support readers of my books and other programmers that go there with programming related questions. I try to answer as many questions as I can but I only have a limited amount of time. This means I'll give preference to questions that are the easiest to answer. This is not related to the technical difficulty of the problem discussed, but to the quality of the question. Obviously, if you post a clear and concise question, you increase your chances of getting a useful and quick reply as it takes less time to understand the question and come up with an answer. Unfortunately, I see more and more people posting vague questions, and posting them in the wrong category. To avoid typing the same response over and over again asking for clarification, I decided to write a short blog post with a few tips for proper questions in these forums where I can refer to when unclear questions come up. If you get sent to this page, it's not that people don't want to help you; it's that they can't help you because the question is unclear or posted in an inappropriate location. Follow these tips and you'll improve the chances of getting the answer you're waiting for.
Choose an appropriate forum
If your question is about a specific book, post your message in that book's forum. If the question is not directly related to a book, choose a general forum for the technology your question is about. For example, if you have a question directly related to the book Beginning ASP.NET 4 in C# and VB, choose the forum BOOK: Beginning ASP.NET 4 : in C# and VB. For general question about ASP.NET 4, choose ASP.NET 4 General Discussion. Other books and technologies follow a similar pattern.
You can find the forum for your book on the main forum list, or from the book's details page which you can find using the book list page. Here you can search for your book by its title, author or ISBN number.
Specify chapter and page number and other relevant details
When you post a question about a book, please specify both the chapter number and the page number, if available. This makes it easier for an author to look up the stuff you're talking about in digital versions of the book, or in source code. Additionally, provide other relevant information such as "Try It Out Exercise, step 4". "I have a problem with chapter 12" makes it time-consuming to find the relevant part of that chapter you're talking about. Likewise, "on page 236 I run into problem XYZ" makes it difficult to find the associated source for that chapter. Specifying both makes these things a lot easier.
Post relevant code
This sounds obvious, but I see many questions about code without code examples. The typical response you get to questions like these is often "can you please post the relevant code" which just delays your answer, or you may get the following:
>> The error is on line 11 > How do you know? I didn't post any code Exactly!
In other words, we can't say anything useful about your code if we don't see your code.
Make your code easy to read
Don't just copy and paste code from your editor but spend some time to make it more readable. It's in your own interest that the reader of your message can easily understand and read what you've posted. Due to an annoying bug in the forum's post editor, code pasted from Visual Studio gets screwed up if you don't remove the formatting first. To post readable code, try this:
- Paste the code in a Notepad document and then copy it from there. This removes all color coding.
- Paste the code in the forum's post editor, select it and click the Remove Text Formatting button on the toolbar
- Wrap the code in a pair of [code] tags by clicking the Wrap Code button (with the # symbol on it). This ensures that code is not mangled when displayed and keeps stuff as spacing and line breaks as you post them.
Post relevant code only when possible
Ask relevant questions
Just before you hit the Submit button on your post, look back and see if your question makes sense. More often than not, people reading your question don't have the book or source code you're talking about. This means you need to provide detailed information about the problem so it can be understood by people unfamiliar with what you are working on.
Try to describe the problem and any behavior you witness as detailed as possible. "I am getting an error" or "When I apply that attribute it doesn't take" provide no meaningful context. Explain what "doesn't take" mean in your case, and post the exact error message and stack trace when available.
Check your spelling
Don't use MSN speak, but try to write in plain English. "i wnt 2 knw" does *not* mean "I want to know"; all it does is show you're too lazy to type. Readers of your post will think you're lazy in general, think you may have not researched your own topic, and will generally ignore the question.
Where to Next?
Wonder where to go next? You can read existing comments below or you can post a comment yourself on this article.
Links in this Document
|Written by||Imar Spaanjaars|
|Date Posted||08/16/2010 11:06|
Talk Back! Comment on Imar.Spaanjaars.Com
I am interested in what you have to say about this article. Feel free to post any comments, remarks or questions you may have about this article. The Talk Back feature is not meant for technical questions that are not directly related to this article. So, a post like "Hey, can you tell me how I can upload files to a MySQL database in PHP?" is likely to be removed. Also spam and unrealistic job offers will be deleted immediately.
When you post a comment, you have to provide your name and the comment. Your e-mail address is optional and you only need to provide it if you want me to contact you. It will not be displayed along with your comment. I got sick and tired of the comment spam I was receiving, so I have protected this page with a simple calculation exercise. This means that if you want to leave a comment, you'll need to complete the calculation before you hit the Post Comment button.
If you want to object to a comment made by another visitor, be sure to contact me and I'll look into it ASAP. Don't forget to mention the page link, or the Doc ID of the document.
Please correct the following errors:
Unfortunately, something went wrong and your message or comments have not been submitted successfully.
There's a fair chance things broke down because you tried to post something that looks like HTML. Things that look like HTML include (X)HTML, obviously, XML, ASP.NET markup and c# generics syntax as all of them use the < and > characters.
If that's the case, try altering your message and remove anything that looks like an angled bracket. You can replace them with [ and ] for example so you can still make it look like HTML to some extend.
If, on the other hand, you were trying to spam this web site, I am pretty glad I caught you in the act and stopped you from doing so ;-)
Also, please don't use links in your posts; I had to block them to filter out most of the junk mail I am receiving.