Welcome!

Eclipse Authors: Pat Romanski, Elizabeth White, Liz McMillan, David H Deans, JP Morgenthal

Blog Feed Post

The New Codeship Documentation

Codeship Documentation Header

How to handle increasing support requests

Over the last couple of months Codeship grew tremendously. We run more builds and deployments for a growing number of companies. We are always striving to make the setup on the Codeship a success for everyone, so thoroughly answering all support requests is really important for us. With the aforementioned growth our time invested into support increased a lot.

On the one hand we want to provide easy accessible information through our documentation and in app help and on the other hand it lets us focus more on specific support requests and on improving the product.

Automated messages for common errors

One important improvement was our recent automated error messages feature. We often see typical error messages in the log and in our support requests. For these error messages we show you a support message. This helps all of our users get a quick feedback and therefore doesn’t require additional support from us.

For example in the following image you can see an error message that a ruby gem was potentially removed from rubygems. This immediately tells you what the problem is.

Common Errors – Automated Message

We’ve added several auto-detections of common error messages and will be adding more in the future.

But this was only a first step. We needed to overhaul our docs. Not just to bring in more and better documentation, but also to have a better workflow in place to build on them.

Navigating through the Documentation

Codeship Documentation Overview Page

On the left side you can see all the different support categories.

You can use the tags we add to every article to jump to other relevant articles or search through the documentation on the top search bar.

You can get an overview on all the languages, databases or other technologies we support. Of course we added some information on our setup, general system, frequently asked questions and specific deployment guides.

We implemented our docs as static pages with Middleman and host them on Amazon S3. We will publish a blog post soon that will go into the details of the technology and workflow for our docs.

Our docs are open source on our Github repository. Let us know if you think we can improve our documentation, find errors in them or have general tips. We’re always eager for feedback and of course also for pull requests.

Have a look at our new documentation here.

Conclusions

After focusing on our product and technology for a while we are now putting a lot more of our time into usability and general ease of use. Great support and an easy and quick way to get the information you truly need are an important part of this. Now that we have the technology in place to move quickly with our docs we will put a lot of time into this, so Codeship becomes even easier to use and simpler to understand. The new documentation will help you get the relevant information you need as quickly as possible.

Ship long and prosper!

Read the original blog entry...

More Stories By Manuel Weiss

I am the cofounder of Codeship – a hosted Continuous Integration and Deployment platform for web applications. On the Codeship blog we love to write about Software Testing, Continuos Integration and Deployment. Also check out our weekly screencast series 'Testing Tuesday'!

IoT & Smart Cities Stories
Every organization is facing their own Digital Transformation as they attempt to stay ahead of the competition, or worse, just keep up. Each new opportunity, whether embracing machine learning, IoT, or a cloud migration, seems to bring new development, deployment, and management models. The results are more diverse and federated computing models than any time in our history.
At CloudEXPO Silicon Valley, June 24-26, 2019, Digital Transformation (DX) is a major focus with expanded DevOpsSUMMIT and FinTechEXPO programs within the DXWorldEXPO agenda. Successful transformation requires a laser focus on being data-driven and on using all the tools available that enable transformation if they plan to survive over the long term. A total of 88% of Fortune 500 companies from a generation ago are now out of business. Only 12% still survive. Similar percentages are found throug...
At CloudEXPO Silicon Valley, June 24-26, 2019, Digital Transformation (DX) is a major focus with expanded DevOpsSUMMIT and FinTechEXPO programs within the DXWorldEXPO agenda. Successful transformation requires a laser focus on being data-driven and on using all the tools available that enable transformation if they plan to survive over the long term. A total of 88% of Fortune 500 companies from a generation ago are now out of business. Only 12% still survive. Similar percentages are found throug...
Dion Hinchcliffe is an internationally recognized digital expert, bestselling book author, frequent keynote speaker, analyst, futurist, and transformation expert based in Washington, DC. He is currently Chief Strategy Officer at the industry-leading digital strategy and online community solutions firm, 7Summits.
Digital Transformation is much more than a buzzword. The radical shift to digital mechanisms for almost every process is evident across all industries and verticals. This is often especially true in financial services, where the legacy environment is many times unable to keep up with the rapidly shifting demands of the consumer. The constant pressure to provide complete, omnichannel delivery of customer-facing solutions to meet both regulatory and customer demands is putting enormous pressure on...
IoT is rapidly becoming mainstream as more and more investments are made into the platforms and technology. As this movement continues to expand and gain momentum it creates a massive wall of noise that can be difficult to sift through. Unfortunately, this inevitably makes IoT less approachable for people to get started with and can hamper efforts to integrate this key technology into your own portfolio. There are so many connected products already in place today with many hundreds more on the h...
The standardization of container runtimes and images has sparked the creation of an almost overwhelming number of new open source projects that build on and otherwise work with these specifications. Of course, there's Kubernetes, which orchestrates and manages collections of containers. It was one of the first and best-known examples of projects that make containers truly useful for production use. However, more recently, the container ecosystem has truly exploded. A service mesh like Istio addr...
Digital Transformation: Preparing Cloud & IoT Security for the Age of Artificial Intelligence. As automation and artificial intelligence (AI) power solution development and delivery, many businesses need to build backend cloud capabilities. Well-poised organizations, marketing smart devices with AI and BlockChain capabilities prepare to refine compliance and regulatory capabilities in 2018. Volumes of health, financial, technical and privacy data, along with tightening compliance requirements by...
Charles Araujo is an industry analyst, internationally recognized authority on the Digital Enterprise and author of The Quantum Age of IT: Why Everything You Know About IT is About to Change. As Principal Analyst with Intellyx, he writes, speaks and advises organizations on how to navigate through this time of disruption. He is also the founder of The Institute for Digital Transformation and a sought after keynote speaker. He has been a regular contributor to both InformationWeek and CIO Insight...
Andrew Keys is Co-Founder of ConsenSys Enterprise. He comes to ConsenSys Enterprise with capital markets, technology and entrepreneurial experience. Previously, he worked for UBS investment bank in equities analysis. Later, he was responsible for the creation and distribution of life settlement products to hedge funds and investment banks. After, he co-founded a revenue cycle management company where he learned about Bitcoin and eventually Ethereal. Andrew's role at ConsenSys Enterprise is a mul...