InfoQ Homepage Documentation Content on InfoQ
-
Mozilla Retools MDN to Improve Web Documentation
Mozilla has announced their plans to retool MDN, renaming it MDN Web Docs, separating it from the product documentation. Among developers, MDN is known as as one of the go-to places for high quality documentation. Mozilla wants to "solidify MDN as the single best resource for Web docs".
-
GitHub Surveys Open Source: Documentation, License, Usage at Work
GitHub has conducted a survey on open source projects, publishing the results they found analyzing the data collected. They were interested in how developers relate to open source, what the role of documentation is and the level and impact of negative interactions appearing in projects.
-
Announcing a Unified .NET Documentation Experience
Microsoft has announced its new .NET API browser for finding .NET documentation in a standardized manner. Community contributions to the documentation will be enabled within the next month. The User Voice site allows users to request improvements, and vote on which suggestions are most important including additional documentation users want to see added to the API browser.
-
Stack Overflow Launches Documentation Beta
Stack Overflow has launched a new website called Documentation, enabling developers to create documentation on various software development topics for developers.
-
Puppet Releases Docker-Focused Features in Project Blueshift
In context of its Project Blueshift, Puppet has added a new set of Docker images for running Puppet software released to Docker Hub. Blueshift is a demonstration of solutions to the problem of managing heterogeneous software, using Puppet as the unified way of managing the new software stack.
-
-
MSDN/TechNet Being Replaced by Open Source Project docs.microsoft.com
After 15 years of running on a “brittle codebase with an archaic publishing and deployment system”, Microsoft has finally decided to retire MSDN and TechNet. The replacement will be an open source project known as docs.microsoft.com.
-
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.