Systems | Development | Analytics | API | Testing

Documentation

How to Document Your REST API Like a Pro

REST API is an application programming interface that continues to grow in popularity due to its flexibility and scalability. In this detailed guide, we will outline how to document your REST API like a pro, guiding you through the process clearly and concisely to make things as easy as possible. From the basics, what you need to include, and all the way to the tips and tricks, we will provide everything you need to know to create perfect documentation.

Livebook for Elixir: Just What the Docs Ordered

While initially conceived as a tool for data exploration (much like Jupyter for Python), Livebook has deservedly become a sensation in the Elixir community. It has been fantastic to see all the wonderful ways teams are leveraging Livebook for a range of different use cases. We have seen Livebooks being used to: Livebooks have also been used as the default REPL interface for project development.

The endless capabilities of Storybook

As a developer, I am a massive fan of documentation and (as you can probably tell from my previous blog post) also a big fan of Storybook. If you’re interested in what Storybook is and how to set it up, or integrate it into your existing project, you can find out more about that here. However, in this post, I am going to be outlining why you should be using Storybook and each of its features and capabilities.

Readme: Beautiful solution for dev's documentation

Technology has completely changed the way business houses function today. Most of them have gradually started shifting from the traditional ways of creating their own services to the newer and smoother approach of deploying APIs. APIs have the potential to increase a firm’s revenue while extending their consumer reach. As such, having a tool that helps build quality API documentation is essential.

7 Tips for Designing Great API Documentation

API automation is leading the way for data-driven digital transformation. When developers are able to build modern applications for a variety of devices without having to manage server-side code and complexity, and other departments can tap into a well-designed API documentation system instead of a silo of cumbersome, unorganized code bases, your company will be well on its way to an API-first delivery model.

Speed-Review API Specifications with Insomnia

As the software application world moves from monolith architectures to microservices, we are also seeing a shift toward developing modular and reusable APIs. According to APIOps, reusable APIs are consumable APIs, which means they must be well-documented and compliant. The separation between the designers, builders and consumers of an API grows larger and larger, making the API specification even more central to that API’s success.

Summer School at Collaborator: Session #3 - Ramping up with New Review Types

In its early inception Collaborator was known as Code Collaborator, with the focus of offering a platform for peer review of code files. Parts of that first moniker are still present in the current version of Collaborator: In the name of the executables for example, in case one wonders why there’s the extra ‘c’ at the beginning of those file names. Dropping the ‘Code’ piece of the name, Collaborator evolved into a much more expansive peer review tool, moving beyond just code files, to include document review for many types of files, and with the latest integration, Simulink model files.

End-to-End Document Review and Management - Collaborator Announces Support of Simulink

In some ways, the most valuable contribution of the project owner is to deliver a reviewed set of documents, code, and peer insights. However, this level of collaboration for models and equations can be challenging, and manual/visual inspection could lead to errors.

What Is Document Review?

In the context of the software development lifecycle (SDLC), document review makes it easier for an organization to curate, govern, and manage the lifecycle of digital artifacts beyond source code. These include documentation, spreadsheets, presentations, image flies, system and architectural images, and other files related to software projects. It is a discipline often practiced in regulated industries, or where quality certification is a requirement.