{"action":"opened","issue":{"url":"https://api.github.com/repos/angular/angular.io/issues/2303","repository_url":"https://api.github.com/repos/angular/angular.io","labels_url":"https://api.github.com/repos/angular/angular.io/issues/2303/labels{/name}","comments_url":"https://api.github.com/repos/angular/angular.io/issues/2303/comments","events_url":"https://api.github.com/repos/angular/angular.io/issues/2303/events","html_url":"https://github.com/angular/angular.io/issues/2303","id":176140724,"number":2303,"title":"[2.0] Drop `<template [ngIf]=\"\">` syntax from docs & examples ","user":{"login":"vicb","id":248818,"avatar_url":"https://avatars.githubusercontent.com/u/248818?v=3","gravatar_id":"","url":"https://api.github.com/users/vicb","html_url":"https://github.com/vicb","followers_url":"https://api.github.com/users/vicb/followers","following_url":"https://api.github.com/users/vicb/following{/other_user}","gists_url":"https://api.github.com/users/vicb/gists{/gist_id}","starred_url":"https://api.github.com/users/vicb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vicb/subscriptions","organizations_url":"https://api.github.com/users/vicb/orgs","repos_url":"https://api.github.com/users/vicb/repos","events_url":"https://api.github.com/users/vicb/events{/privacy}","received_events_url":"https://api.github.com/users/vicb/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2016-09-10T00:11:09Z","updated_at":"2016-09-10T00:11:09Z","closed_at":null,"body":"While working on the `NgIf` API docs we first thought about documenting:\r\n- `<single-root *ngIf=exp>`\r\n- `<template [ngIf]=exp><root1><root2></template>\r\n\r\nHowever this is confusing, we will drop the `<template []>` notation from the API docs - note that it will still be supported and there is no plan to remove the support.\r\n\r\nThe preferred way will be `<ng-container *ngIf=exp><root1><root2></ng-container>`\r\n\r\nThe `<ng-container>` tag is used to group nodes together and is not stamped out in the resulting DOM. It is not a directive but a special angular construct.\r\n\r\nWe think that this change will remove some confusion and hard to remember syntax.\r\n\r\nPlease ping me if you need additional info.\r\n\r\n/cc @IgorMinar"}}
{"actor":{"display_login":"vicb"}}