InfoQ Homepage Documentation Content on InfoQ
-
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.
-
Packaging Visual Studio Help Files
If you are offering a commercial or open source library for .NET developers, including an integrated help file is a great way to show your professionalism. It can also be handy when working on a framework that is reused across a company’s internal applications. In a recent article Jeff Braaten explains the process of creating Visual Studio Help Files.
-
Agile and the Crutches of False Confidence
False confidence is often grounded in wishful thinking. It is defined as a state where the projected reality and the actual reality might differ considerably, however for a limited period of time, it does give a feeling of having everything under control. There are many such situations in Agile development which make a team hold onto the false confidence crutch only to fall later.
-
Do Use Cases Have a Place In Scrum?
In Scrum, requirements are commonly expressed as user stories. But is it OK to also make use of use cases in Scrum? And, if so, under what circumstances should you do so?
-
10 Suggestions for the Architect of an Agile Team
Tom Hollander, a Solutions Architect at Microsoft Australia, held a presentation entitled The Role of an Architect in an Agile Team at TechEd Australia where he discussed what he does as an architect leading an agile team.
-
How to Pay the Author: Flattr Micropayment Service
Earlier this year the micropayment service flattr (a wordplay of flatrate and flatter) went live. The principle is simple but could change the way in which we reward quality content on the net. Flattr was initiated by one of the founders of The Pirate Bay, Peter Sunde, who also presented it at social media conferences like re:publica.
-
Agile Documentation: Is There Clarity?
Agile documentation is not exactly the most clear cut subject in the community? How much documentation should we create? What works? What doesn't? How do we transform from a traditional process to an agile one with regards to documents? This is an area that lacks clarity in the agile community.
-
Debate: Comparing NHibernate and EF 4
Recently, a post by Oren Eini (a.k.a. Ayende Raheim) touched off a debate around the respective merits and capabilities of NHibernate and Entity Framework 4.0, two .NET-based Object/Relational Maping frameworks. InfoQ explored this debate in more detail to understand some of the perspectives which were given.
-
Ruby Tools: Yard 0.4 Adds Live Doc Server, Gem Bundler Handles Dependencies
Documentation generator Yard's 0.4 release adds new features such as a live documentation server which allows users to comment on the docs. The new tool Gem Bundler allows flexible dependency management.