A big part of what you buy is your entitlement to fast and friendly expert technical support. Much of the success of RapidWeaver has been down to willingness of people available to help each other.
Developers want to help, but sometimes the response you get will depend on how you initiate your first communication. Take these two emails as an example:
purchased this software and added it it to my page but it nott working. WHY? total scam. many houurs and moneys wasted
RE: Bullet point spacing
I purchased your AmazeBalls list stack (version 1.2) and it has been brilliant to setup and use. However I have noticed on the published web page (www.example.com 1) that the spacing around the bullets is slightly off-centre by a couple of pixels. I have attached an annotated screenshot to this email too, and the red line is where I would expect the bullet points to line-up. I think it might be something to do with line height settings in this theme? It is the same in both Safari 10 and Firefox 60. I have tried clearing my browser cache and doing a full republish of the website from RapidWeaver. Do you happen to know how I can adjust this please? Thank you in advance and I hope all is well with you across the pond!
Those are emails from two actual RapidWeaver users. Which one would you prefer to receive and reply to?
The first email is completely devoid of any useful information. We have no idea what the person is using or how to replicate the problem. Being able to replicate a problem is a significant part of being able to resolve it. The poor writing skills and rudeness means this email is probably going straight into the trash without ever receiving a response. It’s simply not worthy of any attention. Its kind-of selfish and lazy to send emails like this one.
The second email has probably taken no longer than a few minutes to write. But it contains absolutely everything we need to know. The customer has already made an attempt to do some basic troubleshooting themselves. They have been totally clear in what they are using and where to replicate the issue. This email will definitely get an immediate response and John would be assured the custom CSS we give him will work splendid.
So please - consider the person at the other end you are contacting when sending an email or asking for help on a forum. A detailed message does not take long to write and you will be rewarded with the reply you want straight away (without a needless volley of messages backwards and forwards for several days or weeks).
At the very minimum, your support message should always include:
- The exact name and version number of the RapidWeaver addon being used.
- A description of what’s not working, versus what you were expecting instead.
- Simple steps to replicate the problem, browser names, versions etc.
- Anything you have tried so far yourself towards resolving the problem.
- The link to the published test page on your web server and / or screenshot.
Reporting bugsThe same template above can be used for reporting bugs too. Send bug reports direct to the developer. Refrain from posting them to public forums or social media, because they can be wrongly misinterpreted by other users and start giving false impressions of certain addons being permanently defective. In other words, don’t air your dirty laundry! Most developers would rather track and fix issues internally, and provide you a positive outcome more quickly.
Project filesLinks to download RapidWeaver project files (so we can open the project inside RapidWeaver) can sometimes be useful. But they can prove less useful if the pages are made-up of numerous third-party addons from other companies. It may be better to duplicate a project file and delete-out everything that is not needed, to reduce the project down to a single page, comprising of only the most essential addons needed. If you need more help on packaging and sending a project file, please see this knowledge base article.
Taking screenshots / screen grabsWe find quite a lot of novice Mac users don’t know how to take screenshots. Unlike Windows, Mac does not have a ‘print screen’ button. To take a screenshot on Mac, simultaneously press ⇧ ⎇ 4 Space (shift + alt + 4 + space) on your keyboard. And here is a video showing two other methods of how its done.
The screenshot normally gets saved to your desktop as a PNG image. You can annotate it with arrows, lines or other shapes using Preview in your Applications folder, pictured below.
This makes is much easier to describe things you want changed or fixed. “A picture is worth a thousands words”, as we often say.
Displaying diagnostic informationIf you think a developer is going to need more information about your RapidWeaver and web server configuration (e.g. PHP), add a free UsefulStack to a webpage and toggle-on the Display Debug Information option. Either an existing webpage or a new webpage added to the website. Publish the webpage and provide its URL. This simple action will output a lot of highly useful statistics and other information about your setup, as pictured below.
UsefulStack will output the following in debug mode:
- Details of the web browser viewing the page or being used.
- Version / build numbers of RapidWeaver and Stacks.
- Location and configuration of the page within the website.
- A complete output of all PHP and MySQL configuration details.
Sometimes for more complicated addons (like those that use server-side PHP or MySQL databases), there is very little the developer can view from outside the server. The nature of these programming languages means that much of the code is locked-away deep within the server environment. It may be necessary to create a temporary FTP account and CPanel login, for a developer to access your hosting server.