BT
JavaScript Follow 384 Followers

TSDoc: A TypeScript Source Code Documentation Format

by Dylan Schiemann Follow 7 Followers on  Apr 19, 2018

TSDoc proposes a new format for documenting TypeScript source code. Existing TypeScript API documentation parsers accept a syntax based on JSDoc, but the extensions to JSDoc are inconsistent across implementations.

HTML5 Follow 65 Followers

Microsoft, Google, and Mozilla Team Up for Web Documentation

by David Iffland Follow 4 Followers on  Oct 24, 2017

In a coordinated announcement, three major browser vendors have agreed to consolidate their individual web API reference documentation into Mozilla's MDN and have formed an advisory group to guide future efforts. The groups will start using MDN as a single point of truth for web platform documentation and reference.

Culture & Methods Follow 672 Followers

How Blogging Empowers Agile Teams

by Ben Linders Follow 25 Followers on  Oct 05, 2017

Moving the thinking and decisions a team makes from people’s inboxes onto a blog can make it accessible to all, findable in the future, and referenceable by everyone. Instead of writing documentation, you can use blogumentation to transfer knowledge and document the history of projects that provide context to the code.

JavaScript Follow 384 Followers

Mozilla Retools MDN to Improve Web Documentation

by David Iffland Follow 4 Followers on  Jun 20, 2017

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".

Development Follow 610 Followers

GitHub Surveys Open Source: Documentation, License, Usage at Work

by Abel Avram Follow 9 Followers on  Jun 03, 2017 1

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.

.NET Follow 377 Followers

Announcing a Unified .NET Documentation Experience

by Michael Stiefel Follow 6 Followers on  Apr 28, 2017

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.

Development Follow 610 Followers

Stack Overflow Launches Documentation Beta

by Abel Avram Follow 9 Followers on  Jul 21, 2016 1

Stack Overflow has launched a new website called Documentation, enabling developers to create documentation on various software development topics for developers.

DevOps Follow 827 Followers

Puppet Releases Docker-Focused Features in Project Blueshift

by John Okoro Follow 1 Followers on  Jul 20, 2016

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.

DevOps Follow 827 Followers

DevOps Days Kiel Day 1

by Manuel Pais Follow 9 Followers on  May 15, 2016

Summary of DevOps Days Kiel day 1 talks.

.NET Follow 377 Followers

MSDN/TechNet Being Replaced by Open Source Project docs.microsoft.com

by Jonathan Allen Follow 576 Followers on  May 04, 2016

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.

Web API Follow 244 Followers

Interview with Readme.io Founder on the Future of API Documentation

by Jerome Louvel Follow 1 Followers on  Aug 27, 2015

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.

Followers

Ilan Goldstein on a Scrum Myth Buster Series

by Savita Pahuja Follow 2 Followers on  Aug 20, 2015 1

This post covers scrum myths described by Ilan Goldstein, Certified Scrum Trainer.

Followers

State of Testing 2015 Report is Published

by Ben Linders Follow 25 Followers on  Jul 02, 2015 3

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.

Followers

DDD and Living Documentation

by Jan Stenberg Follow 34 Followers on  Jun 15, 2015 4

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.

Followers

Agile Architecture: Reversibility, Communication and Collaboration

by Daniel Bryant Follow 702 Followers on  May 04, 2015

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.

Login to InfoQ to interact with what matters most to you.


Recover your password...

Follow

Follow your favorite topics and editors

Quick overview of most important highlights in the industry and on the site.

Like

More signal, less noise

Build your own feed by choosing topics you want to read about and editors you want to hear from.

Notifications

Stay up-to-date

Set up your notifications and don't miss out on content that matters to you

BT