google / google/closure-templates

Proposal: Closure Templates Change and Release Policy

Open
#69 19 comments 2 reactions 0 assignees View on GitHub
rfc
Dominant language
Java
Stars
700
Forks
199
Avg merge
2d 12h
Merged PRs (30d)
26

Description

# Motivation

Closure Templates is a mature product with widespread use both inside Google and in the open-source world. In general, we don’t want to change the workflow for writing Closure Templates or the language features available to template authors. Rather, we want to **make it easier to use the best possible Closure Templates features** (and conversely, make it harder or impossible to use Closure Templates in an insecure or non-performant way). We think it is worthwhile to occasionally make breaking changes to Closure Templates in pursuit of this goal.
# Proposed Policy
1. Closure Templates will be released monthly, as close to the start of the month as possible. A release will consist of artifacts published to Maven Central, as well as a release tag in the GitHub repo.
2. We will keep a `BREAKING_CHANGES.md` file in the GitHub repo. This file will be updated every release to describe breaking changes since the last release (if any), and what steps open-source users need to take to upgrade.
3. For every release, we will make an announcement on closure-templates-discuss, pointing to the Maven artifacts, the GitHub tag, the breaking changes, etc.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.