Results 1 to 14 of 14
  1. #1
    Writing a Quality Post
    vansmith's Avatar
    Member Since
    Oct 19, 2008
    Location
    Toronto
    Posts
    19,389
    Specs:
    2012 13" MBP (2.5 i5, 8GB)
    Writing a Quality Post
    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 by vansmith; 07-16-2014 at 12:56 PM. Reason: I don't grammar good.
    Important Links: Community Guidelines : Use the reputation system if you've been helped.
    M-F Blog :: Write for the blog
    Writing a Quality Post

  2. #2
    Writing a Quality Post
    cradom's Avatar
    Member Since
    Feb 14, 2004
    Location
    Nederland, Texas
    Posts
    4,072
    Specs:
    13in macbook - 10.10.4
    This should have been posted years ago. Good job.
    Craig Domingue
    (\__/)
    (='.'=) This is Bunny. Copy and paste Bunny into your
    (")_(") signature to help him gain world domination

  3. #3
    Writing a Quality Post
    vansmith's Avatar
    Member Since
    Oct 19, 2008
    Location
    Toronto
    Posts
    19,389
    Specs:
    2012 13" MBP (2.5 i5, 8GB)
    Thanks Craig, much appreciated.
    Important Links: Community Guidelines : Use the reputation system if you've been helped.
    M-F Blog :: Write for the blog
    Writing a Quality Post

  4. #4
    Writing a Quality Post
    harryb2448's Avatar
    Member Since
    Nov 28, 2007
    Location
    Nambucca Heads Australia
    Posts
    20,002
    Specs:
    iMac i5 2.7GHz, 16GB memory, OS 10.10.5
    Good luck van!
    Hang on to those original install discs like grim death! Using OS X.7 or later make a bootable USB thumb drive before running Installer!

  5. #5
    Writing a Quality Post
    toMACsh's Avatar
    Member Since
    Jul 30, 2009
    Location
    Wisconsin
    Posts
    5,826
    Specs:
    Mac Mini Core 2 Duo
    Quote Originally Posted by harryb2448 View Post
    Good luck van!
    What? Getting people to read it? (much less, follow it!)

    Good info though.

  6. #6
    Writing a Quality Post
    chscag's Avatar
    Member Since
    Jan 23, 2008
    Location
    Fort Worth, Texas
    Posts
    45,173
    Specs:
    27" iMac i5, 3.2 GHz, iPad 3, iPhone 5c, iPhone 6+, 3 iPods, Yosemite
    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.

  7. #7
    Writing a Quality Post

    Member Since
    Sep 20, 2014
    Posts
    4
    Very nice and informative post. I need to know about posting backlinks.

  8. #8
    Writing a Quality Post
    RadDave's Avatar
    Member Since
    Jan 20, 2012
    Location
    North Carolina
    Posts
    2,531
    Specs:
    MBP 13" (2013); 2.6 GHz i5; 8 GB RAM; SSD 256 GB; OS 10.10.5
    Quote Originally Posted by toMACsh View Post
    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

  9. #9
    Writing a Quality Post
    chscag's Avatar
    Member Since
    Jan 23, 2008
    Location
    Fort Worth, Texas
    Posts
    45,173
    Specs:
    27" iMac i5, 3.2 GHz, iPad 3, iPhone 5c, iPhone 6+, 3 iPods, Yosemite
    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.

  10. #10
    Writing a Quality Post

    Member Since
    Jul 11, 2014
    Posts
    206
    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.

  11. #11
    Writing a Quality Post
    harryb2448's Avatar
    Member Since
    Nov 28, 2007
    Location
    Nambucca Heads Australia
    Posts
    20,002
    Specs:
    iMac i5 2.7GHz, 16GB memory, OS 10.10.5
    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!
    Hang on to those original install discs like grim death! Using OS X.7 or later make a bootable USB thumb drive before running Installer!

  12. #12
    Writing a Quality Post

    Member Since
    Dec 11, 2012
    Location
    London
    Posts
    8
    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.

  13. #13
    Writing a Quality Post

    Member Since
    May 30, 2015
    Posts
    16
    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.

  14. #14
    Writing a Quality Post
    chscag's Avatar
    Member Since
    Jan 23, 2008
    Location
    Fort Worth, Texas
    Posts
    45,173
    Specs:
    27" iMac i5, 3.2 GHz, iPad 3, iPhone 5c, iPhone 6+, 3 iPods, Yosemite
    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.

Thread Information

Users Browsing this Thread

There are currently 1 users browsing this thread. (0 members and 1 guests)

Similar Threads

  1. Writing in HD
    By greenawayk in forum Movies and Video
    Replies: 3
    Last Post: 10-07-2012, 02:11 PM
  2. Writing DVDs
    By WaHiL in forum Switcher Hangout
    Replies: 6
    Last Post: 07-25-2009, 08:51 PM
  3. Writing Cookies
    By RobDreugan in forum Web Design and Hosting
    Replies: 4
    Last Post: 12-24-2003, 11:35 AM

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •