Writing a Quality Post

Status
Not open for further replies.

vansmith

Senior Member
Joined
Oct 19, 2008
Messages
19,924
Reaction score
559
Points
113
Location
Queensland
Your Mac's Specs
Mini (2014, 2018, 2020), MBA (2020), iPad Pro (2018), iPhone 13 Pro Max, Watch (S6)
So, you've got a problem with your Apple device and need some help. No problem, you've come to the right place. We're happy to help you work through your issue and offer some help but to do so, we've got to work together to better understand the issue that you're dealing with. More often than not, what makes this shared understanding difficult is miscommunication and a lack of detail, both of which are extremely important in online discussions where social cues and context are absent. With that, here are some tips and things to include in posts to help build some shared understanding which, in turn, will help you solve your issue.

Tip #1 - Detail
If in doubt, add that detail that you might think is irrelevant. If something isn't working, tell us about everything you've done with your device in the recent past. If computing devices have one property that make them difficult to fix, it's that everything is connected but not always in an obvious way. For example, an inability to connect to a website may very well have something to do with that note taking software you installed three days ago (yes, sometimes the causal link can be something so seemingly disconnected).

At a minimum, you should provide details about your device and the software involved with your issue. Here's a handy template that you can use:

OS X/iOS version:
Software involved with the issue:
Version number of the software involved:
Piece(s) of hardware involved:
Error message(s):



Tip #2 - Detailed titles
We get a lot of requests each day for help. Given that we can't read everything nor do we each have expertise in all areas, detailed titles can help us figure out where to direct our efforts which, in the end, helps you. While there is no magical formula for how to craft a perfect title, detail again is key. Being concise is also important - be short but clear about what the issue is. You don't need to include version numbers here but software names and the issue are key. Perhaps the best way to explain this is with some examples.

Example #1 - Bad
Can't connect (this tells us nothing about the issue and could be connected to any issue)

Example #2 - Better but still weak
Can't connect to internet on my Mac (this is better but still doesn't tell us much about what's wrong)

Example #3 - Good
Can't connect to internet on my Macbook Pro running OS X 10.9.4 and Safari (this is good in that it tells us what software is having issues but still doesn't tell us much about what connection issues you're encountering)

Example #4 - Great
Can't connect to internet (can't establish secure connection) on my Macbook Pro (OS X 10.9.4) running Safari (this is great - it tells us the specific error and where you're seeing it)


Tip #3 - Be concise and clear
As a volunteer forum, each person here is doing this in their spare time. While we appreciate as much detail as possible, try to be concise. Of equal importance is clarity. One thing to remember is that you're trying to explain your issue to someone who knows nothing about anything to do with your situation. For all we know, you live in a shack outside Scott Base, connecting to us by satellite. Be as clear about your context as possible if it's relevant. For example, if your computer is overheating, being clear about where you're computing matters (if your room is really hot, this matters). The principle of clarity also applies to your wording. When writing your post, pretend that you're reading it to a random stranger on the street. Would it make sense to them? Once you can answer "yes" to that question, feel free to post it.

One thing that falls under this tip is the issue of assumptions. Assume we know nothing about you. This includes everything from what you're using to where you live (if relevant). For example, we often get questions asking where to buy something or whether one can do something legally, both of which, although very different in nature, depend on us knowing where you live (we don't need street details but a country might help).


Tip #4 - We're volunteers so be nice
This isn't so much a tip about the writing as it is about how you ask your question. I can, with almost absolute certainty, guarantee that if you demand help or request immediate assistance, you won't get it. We're under no obligation to help and if you demand assistance, we may respond by taking our time. Therefore, the best way to get any help is to ask politely. I can't stress this enough for not only does it help you but it also sets a tone for the conversation.

Tangentially connected to this is the issue of answering your request for help with more questions. Often, we will ask for more details and when we do so, we do it with the best of intentions. Please do not get frustrated if we ask follow up questions and if we do, please do your best to answer them (we can help if you don't know how to get the information we request).


TL,DR? If in doubt, add detail and be nice.
 
Last edited:
Joined
Feb 14, 2004
Messages
4,781
Reaction score
166
Points
63
Location
Groves, Texas
This should have been posted years ago. Good job.
 
OP
vansmith

vansmith

Senior Member
Joined
Oct 19, 2008
Messages
19,924
Reaction score
559
Points
113
Location
Queensland
Your Mac's Specs
Mini (2014, 2018, 2020), MBA (2020), iPad Pro (2018), iPhone 13 Pro Max, Watch (S6)
Thanks Craig, much appreciated.
 
Joined
Nov 28, 2007
Messages
25,564
Reaction score
486
Points
83
Location
Blue Mountains NSW Australia
Your Mac's Specs
Silver M1 iMac 512/16/8/8 macOS 11.6
Good luck van!
 
Joined
Jul 30, 2009
Messages
7,295
Reaction score
301
Points
83
Location
Wisconsin
Your Mac's Specs
Mac Mini (Late 2014) 2.6GHz Intel Core i5 Memory: 8GB 1600MHz DDR3

chscag

Well-known member
Staff member
Admin
Joined
Jan 23, 2008
Messages
65,248
Reaction score
1,833
Points
113
Location
Keller, Texas
Your Mac's Specs
2017 27" iMac, 10.5" iPad Pro, iPhone 8, iPhone 11, iPhone 12 Mini, Numerous iPods, Monterey
The point here is that we can now refer new users of our forums to this Guide. We understand that there will always be someone who will post a question that's vague or without any supporting information.
 
Joined
Sep 20, 2014
Messages
4
Reaction score
0
Points
1
Very nice and informative post. I need to know about posting backlinks.
 
Joined
Jan 20, 2012
Messages
5,053
Reaction score
414
Points
83
Location
North Carolina
Your Mac's Specs
Air M2 ('22) OS 14.3; M3 iMac ('23) OS 14.3; iPad Pro; iPhone 14
What? Getting people to read it? (much less, follow it!)

Good info though.

@ Van - excellent guidelines - thanks!

But I was wondering if there would be a way for first time posters to have your first post in this thread 'pop up' as required reading before an initial post can be written? I've responded to a lot of first time posters who leave just a sentence or two of often worthless information, and have to just ask for more details - I know many other members have done the same.

Just a thought but not sure that it can be implemented or whether the mods et al. who run this forum would even desire that as an option? Thanks - Dave :)
 

chscag

Well-known member
Staff member
Admin
Joined
Jan 23, 2008
Messages
65,248
Reaction score
1,833
Points
113
Location
Keller, Texas
Your Mac's Specs
2017 27" iMac, 10.5" iPad Pro, iPhone 8, iPhone 11, iPhone 12 Mini, Numerous iPods, Monterey
It's an idea that has merit Dave but would have to be something incorporated into the forum software. Ideally, our new members should be reading the Sticky posts and forum guidelines. Too often a new member is only interested in getting their question answered or problem solved which means everything else is overlooked.
 
Joined
Jul 11, 2014
Messages
296
Reaction score
5
Points
18
Your Mac's Specs
A1286 MBP5,3 running 10.9.5, iphone6, Mac mini1,1 A1176 120/2gb
I know that it has taken me several weeks to get used to this forum. Things are different here than others, but I like it. I have had most of my questions answered, even the dumb ones, and most posts are common sense although there is power through knowledge. I agree that it should have been a "pop up" item though. It was hard to navigate around at first. Ask poor Bob Tomay who's mailbox was filled with questions after I latched on to him ;-) Maybe a header to say "Please include all information" I know it can be frustrating at times.
 
Joined
Nov 28, 2007
Messages
25,564
Reaction score
486
Points
83
Location
Blue Mountains NSW Australia
Your Mac's Specs
Silver M1 iMac 512/16/8/8 macOS 11.6
It is that good van i keep it in my Favourites Bar. And ankhseeker, there are no dumb questions ~ just dumb answers from time to time!
 
Joined
Dec 11, 2012
Messages
8
Reaction score
0
Points
1
Location
London
Thanks for this.....being new to anything is never comfortable - but I will take all this information on board and try my best to adhere to it.
 
Joined
May 30, 2015
Messages
21
Reaction score
0
Points
1
Thank you. I guess I picked the wrong category when posting my query. Please be a bit patient with the older people who belong to this forum. Some of us are still learning how these forums work and are new to
the Apple operating system, as I am myself. Patience is a virtue.
 

chscag

Well-known member
Staff member
Admin
Joined
Jan 23, 2008
Messages
65,248
Reaction score
1,833
Points
113
Location
Keller, Texas
Your Mac's Specs
2017 27" iMac, 10.5" iPad Pro, iPhone 8, iPhone 11, iPhone 12 Mini, Numerous iPods, Monterey
Don't worry about it. If we see a topic posted in the wrong forum, we'll move it for you. Most folks when they first join our forums will try to post everything in the first forum they come to rather than read the forum description first.
 
Status
Not open for further replies.

Shop Amazon


Shop for your Apple, Mac, iPhone and other computer products on Amazon.
We are a participant in the Amazon Services LLC Associates Program, an affiliate program designed to provide a means for us to earn fees by linking to Amazon and affiliated sites.
Top