InfoQ Homepage Documentation Content on InfoQ
-
Interview with Readme.io Founder on the Future of API Documentation
Documentation, one of the great neglected areas of software development, is finally getting some attention, with a number of relatively new tools. For an API documentation can be considered essential. Gregory Koberger is working on a system with the intent of connecting developer documentation more directly to APIs and the API dashboard.
-
Ilan Goldstein on a Scrum Myth Buster Series
This post covers scrum myths described by Ilan Goldstein, Certified Scrum Trainer.
-
State of Testing 2015 Report is Published
The state of testing 2015 report shares results from this year's testing survey that was organized by Joel Montvelisky from PractiTest and Lalit Bhamare from Tea-Time with Testers. It provides insights in the adoption of test techniques and practices, test automation, and the challenges that testers are facing. InfoQ did an interview with the organizers of the survey.
-
DDD and Living Documentation
Creating documentation is boring, it's often obsolete and misleading but with a new mindset both your documentation and code can improve, Cyrille Martraire explained in a presentation showing how to create living documentation when working with Domain-Driven Design (DDD) at this year’s DDD Exchange conference in London.
-
Agile Architecture: Reversibility, Communication and Collaboration
At the inaugural O’Reilly Software Architecture conference, Molly Dishman and Martin Fowler discussed the role of architecture within agile software development. Key takeaways included; architects must remain ‘hands on’; architecture should focus on reducing irreversibility; adaptable documentation is essential; and architecture is a collaborative effort across the business and technical team.
-
Apiary Announces Apiary for Enterprise
Apiary, the company behind API Blueprints has announced a new offering, Apiary for Enterprise, that promotes API design best practices through tooling that validates API designs against defined API style guide standards and best practices. InfoQ caught up with Apiary to shed more light on this new offering.
-
The Importance of Discipline in Agile
Agile software development is sometimes perceived as an undisciplined way of working. There are organizations which use that perception as an excuse to not adopt agile. According to others agile is actually a more disciplined approach than waterfall for software development. Let’s explore how discipline plays a role in agile and why discipline is considered important for agile to be successful.
-
API World 2014: Summary of Day One Events
In this news item, we summarize the highlights of various talks from day one of the conference which are primarily focused on the craft of designing and developing effective APIs.
-
A Look Back at NDoc and Sandcastle
The history of NDoc and Sandcastle is long and sordid. We take a brief look at that history and then check in on their successor, the Sandcastle Help File Builder.
-
Managing your Software Debt
Software debt exists in different ways. Technical debt is widely known, some other forms are competence debt and quality debt. Software debt can cause product maintenance costs to increase and can depress developers. Several solutions exist to manage software debt.
-
Gulp Aiming to Dethrone Grunt
Fractal, a company who has been actively involved in the development of several popular Node.js modules has just released gulp, a new building system which is trying to replace Grunt as the most popular JavaScript task-runner.
-
Documentation in Agile: How Much and When to Write It?
The Manifesto for Agile Software Development values "working software over comprehensive documentation". This core value asks us to think about how much and which kinds of documents are needed and when they need to be written.
-
DevDocs, a One Stop Shop for Reference Documentation
DevDocs combines multiple reference documentation sets, commonly used by software developers, in a single web site. DevDocs takes advantage of this centralization to offer crosscutting features such as a searchable interface, keyboard shortcuts, common layouts or a common table of contents. DevDocs currently includes documentation for HTML, HTTP, Javascript and Ruby, among others.
-
Scala+GWT Brings Scala to the Browser, New Documentation Site and Scala Days 2012 Announced
Scala+GWT makes it possible to run Scala in the browser, the latest release supports most of the language. The new Scala+GWT Eclipse plug-in uses GWT's development mode for faster turnaround. Also, the Scala team announced a new documentation website and the date for 2012's Scala Days conference.
-
Mashery Redefines API Documentation with Interactive I/O Docs
Mashery introduces a new generation of API documentation tooling with I/O Docs. I/O Docs takes the drudgery out of verbose API docs and enlivens the experience through live API calls within the documentation. In this news item, we talk to Neil Mansilla to understand the motivation for building this tool, its current state and its future.