Skip to main content

Experimental comments for Dart API docs

Posted by Seth Ladd

In an effort to help capture tips and clarifications of our API docs, we've just turned on an experimental comment system for api.dartlang.org. We invite the community to help build out a great documentation resource for Dart.

We will moderate the comments heavily, ensuring only actual clarifications, examples, tips, etc remain. We will moderate and possibly delete comments that do not directly assist other users of the API docs. The API doc comments are not the place for:

  • Bugs (please use dartbug.com)
  • Support questions (please use StackOverflow)
  • Discussions (please use misc@dartlang.org)
  • Spam
  • Notes in languages other than English (because we can't moderate those effectively)
  • Links to other websites
The API doc comments are the perfect place for:
  • Snippets showing best practice usage of the API
  • Clarifications of the API
  • Example code using the API
Because we may incorporate information from comments into the documentation, any comment submitted here is under the same license as the documentation.

With your help, this experiment will help you share your experience with the API so that others may have an easier time getting started with Dart.

Popular posts from this blog

Dart in 2016: The fastest growing programming language at Google, 2nd fastest growing in TIOBE Index

Dart was the fastest growing programming language at Google in 2016 with millions of lines of code written. It also made it to TIOBE Index Top 20 this month (see TIOBE's methodology).

It takes time to build something as ambitious as Dart and, in some ways, Dart is still in its infancy. But we're glad the hard work is starting to pay off.

Many thanks to our amazing community!

We're going to celebrate by ... releasing 1.22 next week (as per our usual 6 week release schedule).

The new Google AdSense user interface: built with AngularDart

AdSense is a free, simple way to earn money by placing ads on your website. The team just launched a completely new version of their app for publishers. Read all about it here. We asked Daniel White, the tech lead for the project, some questions because the new UI happens to be built with Dart and Angular2.


AdSense launched way back in 2003. How long is it since the last big redesign?
Last big redesign was called ‘AdSense 3’ and launched about 6 years ago. It was written in Google Web Toolkit (GWT) and the UI has evolved through several iterations - but this is the first ground-up redesign in 6 years. There are a number of long-standing UX issues that we’ve taken the opportunity to solve. A big shout-out to our UX team who’ve been 100% behind this project. We couldn’t have done it without them!

How many software engineers worked on the project?
Purely on the AdSense applications, we have a team of close to 100. Around 25% of them write Dart.

How many lines of code?
We have around 160K LO…

AngularDart 2.1 and new Components

AngularDart got its own dedicated team 5 months ago. Last month, we launched 2.0 final on the Dart Developer Summit. Today, we’re releasing the first minor release after that: 2.1.

Since the focus of AngularDart is Productivity, Performance, Stability, there are no major breaking changes (see the changelog) — but a lot of behind-the-scenes improvements. Your apps will get slightly smaller and faster (even relative to 2.0 which already made huge strides in size and performance since the compiled-from-TypeScript days).

Many features that AngularJS had to implement for JavaScript and TypeScript are not needed in Dart (because Dart already has those features out-of-the-box). So we’re removing them from AngularDart. Renderer is deprecated in favor of plain-old dart:html. NgPlural is going away — Dart programs can use the package:intl library.

New components

On the Dart Developer Summit, we launched AngularDart Components — the material design widgets Google is using in customer-facing apps …