Asking Good Questions; or, Using the Forum for Information
#1✎ 891snail_HelperReceived for being very helpful around SmileBASIC SourceAchievementsOSP Contest 2 Contest ParticipantI participated in the second SmileBASIC Source OSP Contest!Night PersonI like the quiet night and sleep late.Express YourselfHello, Undercover Moderator snail_ here.
I've noticed lately that the forum has been a bit... messy, and hard to navigate for information, especially Activity. This isn't about forum etiquette though, I shouldn't have to explain that. I wanted to explain how asking programming questions should work on our forum, so the information is clear and available for our Future Patrons.
I was really spurred on by this exchange I saw today:
Obviously, you should not make many new question threads per day, but I also want to say that making a super-thread for all your questions is the wrong thing to do as well. For information of this nature, having separate threads for good, clear questions makes it easier for future readers to discover. Our forum is set up for this with the Programming Questions thread.
The most important thing is that you do not ask the same question twice. The first thing to do is to search the site for what you need to know. You should first look in the FAQs category of the forum. This category contains good question threads selected by the staff because we think they're very useful information. (The threads here also serve as good models for questions you may want to ask.) Second, you should check the Programming Questions category for information. Finally, you should search the site with the search bar, or try exploring our Resource pages. Only if you do not find what you need to know should you go ahead and make a new question thread.
If you need to ask a question on the forum, first consider what you're asking and why. Follow this handy guide.
Is it clear? The question you're asking should be clear and specific. There's nothing more frustrating than trying to answer a question with limited information.
Do you understand it? You should also assure you at least somewhat understand what you're asking. Not knowing things is okay, but at least know what you're asking.
Is it on topic? This is Programming Questions, so the question should be related to programming. It doesn't need to be explicitly related to writing code; sometimes, design questions are okay.
Now you're ready to make a post.
Choose a title that clearly relates to the question. Searchability is probably the most important thing about online information; if your thread has a vague title like "help me" or "question", nobody will be able to find it if they're looking for it.
Explain your question specifically in your post. Be thorough, and describe precisely what it is you want. Use clear language. If there is an issue with your code, post the relevant portion of your code. Is your KILL_ENEMY routine not working? Show us what you're doing.
Asking multiple, related questions on the same thread is okay. You should avoid making multiple threads for related information, and following up on the topic of your previous question is fine.
Post in Programming Questions, NOT FAQs. The threads in the FAQs category are selected by admins after they are completed and moved there for safe-keeping. It is not for general posting.
If you've followed these guidelines well, some friendly users will probably come along and answer you, or direct you to useful information. Be cooperative with the people trying to help you. You're on your way to an answer!
Here are some DON'Ts related to asking a question.
Don't ask questions like "How do I make a platformer?" or "How do I make my player jump?" unless you really know what you're doing. These questions are extremely vague and often have many, many different answers. You're better off looking online for game design books or similar. If you have something basic designed but it isn't working, you may consider asking.
Don't ask really short or simple questions if you can avoid it. There are many resources available to you for understanding the absolute basics of SmileBASIC. If you need to, use the chat.
Thank you for your time.
#2✎ 347ToadIsTheBestAvatar TabooI didn't change my avatar for 180 daysWebsiteVideo GamesI like to play video games!HobbiesIntermediate ProgrammerI can make programs, but I still have trouble here and there. Programming Strengthoh cool
#3✎ 67kitesinpowerlinesAvatar BlockI didn't change my avatar for 30 days.WebsiteAvatar EmbargoI didn't change my avatar for 90 daysWebsiteAvatar TabooI didn't change my avatar for 180 daysWebsiteYou should also check resources if you can't find answers to your question in the forums. The tutorials and code snippets are very useful for some specific programming questions.