23 karma · joined August 7, 2008
Edit: fixed link order
[1] https://youtu.be/cUNX3azkZyk?t=135 (video)
[2] https://www.youtube.com/watch?v=PZbqAMEwtOE (video)
With every support request we ask ourselves: Why is this person contacting us? Is there a simple ui change or wording to prevent confusion. Basecamp coined the term "wordsmithing" for this endless process of fine tuning. [1]
Only after we are happy with the amount of support request a feature generates, we document it.
Doing it this way has a couple benefits. You kind of create a long term user test. You can't spoil the user with knowledge from documentation. There is no way you can give hits to the user to perform a the task. With every support request you can multi variant test your explanation.
[1] https://signalvnoise.com/posts/3633-on-writing-interfaces-we... (2013)
Van der Meij, H Wrote a nice article [1] about minimalism in documentation referring to the first how-to guide (First_Minimal_Manual) [2] on how to use smalltalk for an IBM Displaywriter System (1980). This guide is all about just getting started, and if something goes totally wrong, you just reboot the machine.
People learn by doing. For new user, unfamiliar with your service, you have to reassure them that they can undo everything. This allows them to explore the system freely without any anxiety of doing something permanently wrong.
People prefer to be shown what todo instead of being told what to do. Ikea and Lego manuals for instance never tell you to put screw B1 into hole 7A in the right side of panel 14B Screenshots in your help center articles help a great deal with this. But these are hard to maintain, that is why we created Cliperado [3]
[1] https://www.utwente.nl/en/bms/ist/minimalism/
[2] https://www.utwente.nl/en/bms/ist/minimalism/displaywriter.p... (PDF)
With https://cliperado.com we go a step further. It will keep your screenshots up to date for you, and notify you of any changes. We created it to keep our step by step screenshot guides updated with every deploy.
When I hit refresh in cliperado, it takes a couple minutes to refresh all screenshots. Playing a finished loading sound, is too intrusive though.
One feature request. Add an option to keep the finished loading state, until the the tab is focussed again.
You can use it for testing as well. Cliperado runs headless chrome for the refreshes.
For Cliperado we run a full screenshot refresh before every deploy. We've caught various bugs that way. After the deploy, a full refresh and screenshot update for the site and docs takes maybe 5 minutes.
As mentioned in the article "... that company communicated almost entirely via Slack" So where do I digg up the rest? It might be in a voicemail of a colleague.
If slack would implement a push-IMAP api. I could at least drop one app :)
Cliperado wants to make it as easy as possible for user to understand a service and creators to educate their users.
If you’ve ever created an online service, you know how much work it is to put screenshots in your documentation. You know it makes your service way easier to understand, reduces your churn and even increases signups. But it is just too much manual labor to keep the shots up to date. We are creating a solution to fix this and it is coming along pretty nicely. Our stack includes PHP, Python, VueJS, MySQL, Docker, Selenium, Browser Extensions, Bugs, Performance Issues and a sense of humor.
If you have any questions or you are interested - Please reach out to me arjen@cliperado.com
Cliperado is looking for great engineers, who also like to think about why and what they are building and iterate over the solution a couple of times to make something that actually makes sense, both from a user and from a technical point.
So the pitch goes something like this: (needs some work though)
If you’ve ever created an online service, you know how much work it is to put screenshots in your documentation. You know it makes your service way easier to understand, reduces your churn and even increases signups. But it is just too much manual labor to keep the shots up to date.
We are creating a solution to fix this and it is coming along pretty nicely.
Our stack includes PHP, Python, VueJS, MySQL, Docker, Selenium, Browser Extensions, Bugs, Performance Issues and a sense of humor.
If you have any questions or you are interested - Please reach out to me arjen@cliperado.com