BT

InfoQ Homepage Documentation Content on InfoQ

Articles

RSS Feed
  • How the TOGAF Standard Serves Enterprise Architecture

    Any architect working with large enterprise systems has probably looked for guidance on how to manage the complexity and communicate with various stakeholders. This introductory overview of the TOGAF standard explains the structure of the framework, as well as discusses the benefits of using enterprise architecture to manage complex systems.

  • Always Be Publishing: Continuous Integration & Collaboration in Code Repositories for REST API Docs

    API documentation is an often overlooked part of making any API a success. This article explores how to make the documentation part of a continuous integration pipeline keeping it closer to the code itself.

  • Virtual Panel: Document and Description Formats for Web APIs

    In this virtual panel we hear from 4 individuals deeply involved in the Web API space. Each of them has a unique take on the values, benefits, and costs of documentation and description formats in general, and provide their own unique perspective from their vantage points across the Web. They agree on one thing: something must be done to help developers find their way through the world of Web APIs

  • Towards an Agile Software Architecture

    Boyan Mihaylov covers his experience when working with both traditional waterfall software architectures and agile ones. He depicts the similarities and differences between these with a focus on three areas: the specifics of the software architect role, the timespan of the software architecture, and the output of the software architecture.

  • User Story Driven Docs

    At OutSystems we stopped trying to document the UI and started doing user story driven documentation. In this article I'll tell you why you should avoid document the UI, and how to check if you're already doing it. I'll also tell you how focusing on user stories changed our team's culture, and the process we're currently using to create documentation for OutSystems Platform.

  • Profiles on the Web: An Interview with Erik Wilde

    Erik Wilde talks to Mike Amundsen about Profiles, Description, Documentation, Discovery, his Sedola project and the future of Web-level metadata for APIs.

  • Lean Documentation

    Knowledge about system and domain, which is important for both effectiveness and good quality, is best acquired through a dialog, face2face. Unfortunately, there are situations when a dialog is not possible and our only rescue is lean documentation. This article gives you 6 practices how to maximize information while minimizing the number of words. This makes it easy to use and to maintain.

  • Conversation Patterns for Software Professionals. Part 3

    The third article of the Conversation Patterns for Software Professionals series is focused on very powerful tool which is a Conversation Structure. Michael explains the structure and the mechanics of what people call “a talk”, shows how to control the conversation flow and how to navigate through a conversation on purpose.

  • Conversation Patterns for Software Professionals. Part 2

    All too often we that the business people we deal with do not know what they want, in this second article in a series Michael presents some ideas on how to talk to them and how to explore their needs. In this article he discusses formulating questions to be able to uncover the real needs and underlying motivations

  • Conversation Patterns for Software Professionals. Part 1

    All too often we that the business people we deal with do not know what they want, in this first article in a series Michael presents some ideas on how to talk to them and how to explore their needs. In this article he discusses how to manage a conversation, explore the needs and clarify expectations.

  • Book Review: Pro Website Development and Operations

    Overall the book is a quick read that provides some useful insights and potential starting points for enterprise practitioners and technical managers in medium to large enterprises where development and operations are still very defensive towards each other (often driven by conflicting goals) and where a blame culture reigns.

  • A Roadmap to Agile Documentation

    The agile mindset lies on the premise that all the tasks in an application lifecycle create some kind of value to the client. But when it comes to documentation, teams can find it hard to find such value. This article provides an agile approach to the production of different types of documentation, in different phases of an application lifecycle, adapted to the different target audiences.

BT

Is your profile up-to-date? Please take a moment to review and update.

Note: If updating/changing your email, a validation request will be sent

Company name:
Company role:
Company size:
Country/Zone:
State/Province/Region:
You will be sent an email to validate the new email address. This pop-up will close itself in a few moments.