0.57 upgrade Added steps to upgrade gradle version

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,13 @@
+👋 there!
+
+GitHub Issues in this repository are used exclusively for tracking releases or discussions around them. Please do not submit support requests.
+
+For questions or help, please see:
+
+- The React Native [issue section](https://github.com/facebook/react-native/issues)
+- The React Native [help page](http://facebook.github.io/react-native/help)
+- The React Native channel in [Reactiflux](https://discord.gg/0ZcbPKXt5bZjGY5n)
+- The react-native tag on [Stack Overflow](http://stackoverflow.com/questions/tagged/react-native)
+- For feature request, please use [Canny instead](https://react-native.canny.io/feature-requests).
+
+### Please note that this issue tracker is not a help forum - requests for help will be closed.

.markdownlint.json

@@ -1,5 +1,6 @@
 {
   "default": true,
   "line-length": false,
-  "no-duplicate-header": false
+  "no-duplicate-header": false,
+  "MD029": { "style": "ordered" }
 }

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+    "recommendations": [
+        "esbenp.prettier-vscode"
+    ]
+}

README.md

@@ -1,34 +1,45 @@
 # React Native Releases
 
-[![GitHub Issues](https://img.shields.io/github/issues/react-native-community/react-native-releases.svg)](https://github.com/react-native-community/react-native-releases/issues)
-![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)
+[![GitHub Issues](https://img.shields.io/github/issues/react-native-community/react-native-releases.svg)](https://github.com/react-native-community/react-native-releases/issues) ![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)
 
-Stay up-to-date with the release activities of [React Native](https://github.com/facebook/react-native/) by [watching](https://github.com/react-native-community/react-native-releases/subscription) for [status reports](https://github.com/react-native-community/react-native-releases/issues?q=is%3Aopen+is%3Aissue+label%3A%22release+status%22). Follow along as the release notes are prepared and review the overall [changelog](https://github.com/react-native-community/react-native-releases/blob/master/CHANGELOG.md).
+Stay up-to-date with the release activities of [React Native](https://github.com/facebook/react-native/) by [watching](https://github.com/react-native-community/react-native-releases/subscription) for [status reports](https://github.com/react-native-community/react-native-releases/issues?q=is%3Aopen+is%3Aissue+label%3A%22release+status%22). Or you can follow along as the release notes are prepared and help reviewing the overall [changelog](https://github.com/react-native-community/react-native-releases/blob/master/CHANGELOG.md).
 
 ## Release Status Issues
 
-Progress towards release is tracked in issues. Look for these issues labelled _release status_. Soon a standardized format for the update will be published; please be patient while this settles.
+Progress towards release is tracked in issues, based on labels:
 
-Note that these issues are locked to keep conversation focused strictly on the status. Questions about the release should be directed to the [React Native](https://github.com/facebook/react-native/) repository or other communications channels.
+- _release status_: here you can read the status for the future/RC level releases
+- _stable_: here you can read the status for the current stable release
+- _backport requests_: here you can request cherry-picks for the current stable release, that will be included in the next patch version
+
+Note that these issues are made to keep the conversation focused strictly on the status of each one - please refrain from going off-topic.
 
 ## Changelog
 
-The changelog in this repository is a community-provided effort to provide a helpful and informative summary of React Native's rapidly changing codebase. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and emojii use is roughly based on [gitmoji](https://gitmoji.carloscuesta.me/) recommendations.
+The changelog in this repository is a community-driven effort to provide a helpful and informative summary of React Native's rapidly changing codebase along with a full list of commits.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/), and generated via the script described in the next section.
+
+In order to allow additional research, the commits that relate to a change are listed with their hashes. The revisions listed typically are the merge commits, so as to match the code that a user may find in their own copy. Authors are attributed to encourage recognizing the contributors for supporting React Native.
+
+### Changelog helper script
+
+In order to generate the Changelog, we use a script that, given a base version and a target version, checks all the commits between the two versions and parses release notes and authors in the commit message - and then prints it in the terminal for easy/copy paste.
 
-In order to allow additional research, the commits that relate to a change are listed. The revisions listed typically are the merge commits, so as to match the code that a user may find in their own copy. Authors are attributed to encourage recognizing the contributors for supporting React Native.
+To use it first off `git clone` the repo, then `yarn` and finally you can use it like in the following example: `./changelog-generator.js -b v0.57.5 -c v0.57.6`.
 
 ## "When will my fix make it into a release?"
 
-React Native follows a [monthly release cycle](http://facebook.github.io/react-native/versions.html). Once a pull request is merged to the [core `react-native` repo](https://github.com/facebook/react-native), it may take one to two months for the changes to make it to a stable React Native release.
+React Native follows a release cycle not strictly monthly - you can read more [about it here](https://github.com/react-native-community/discussions-and-proposals/issues/17). Once a pull request is merged to the [core `react-native` repo](https://github.com/facebook/react-native), it may take one to two months for the changes to make it into a stable React Native release.
 
 To determine whether a fix or feature is present in a given release, you will need the commit hash where the fix or feature was added to the `master` branch of the core `react-native` repo. If you know the PR, you can look for the comment from **@facebook-github-bot** that says 'closed this in <COMMIT_HASH>'.
 
 Once you have the commit hash, navigate to `https://github.com/facebook/react-native/commit/<COMMIT_HASH>`. Look closely at the commit message, underneath which you will find a list of tags associated with the commit. These tags will tell you which releases contains this commit. For example, commit [5e80d95e034259af8c41b50756a623756cc81a77](https://github.com/facebook/react-native/commit/5e80d95e034259af8c41b50756a623756cc81a77) has the following tags as of this writing: `v0.55.0-rc.0 v0.54.2 v0.54.1 v0.54.0 v0.54.0-rc.4 v0.54.0-rc.3 v0.54.0-rc.2 v0.54.0-rc.0 latest`. These tags tell us that the commit first made it into the 0.54 release candidate, eventually landing in the 0.54 stable release. It is also present, as you'd expect, in the 0.55 release candidate (and should make it to 0.55 stable, and so on).
 
-If the commit is only present in `master` (i.e. has no tags), then the commit has yet to be picked up by a release. You can expect it to be included in the next release candidate that is cut at the beginning of the next month.
+If the commit is only present in `master` (i.e. has no tags), then the commit has yet to be picked up by a release (or it may have been included in a follow up cherry pick for a patch version). You can expect it to be included in the next release candidate that is cut once the designed features have all landed.
 
 ## Backporting/cherry-picking of changes to existing builds
 
-From time to time, [backporting](https://en.wikipedia.org/wiki/Backporting) a change to an existing release (including candidates) may be needed. Examples include security issues or critical regressions. If you believe a pull request on `react-native`  is a candidate for backporting, please mention it in the version associated _backport request_ issue.
+From time to time, [backporting](https://en.wikipedia.org/wiki/Backporting) a change to an existing release (including candidates) may be needed. Examples include security issues or critical regressions. If you believe a pull request on `react-native` is a candidate for backporting, please mention it in the version associated _backport request_ issue.
 
 Please note that, if the change hasn't landed on `react-native`'s master, it can't be cherry picked to a release tag yet.

changelog-generator.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const levenshtein = require('fast-levenshtein');
+
+const argv = require('yargs')
+    .usage('$0 [args]', 'Generate a React Native changelog from the commits and PRs')
+    .options({
+        'base': {
+            alias: 'b',
+            describe: 'the base version branch or commit to compare against (most often, this is the current stable)',
+            demandOption: true
+        },
+        'compare': {
+            alias: 'c',
+            describe: 'the new version branch or commit (most often, this is the release candidate)',
+            demandOption: true
+        }
+    })
+  .version(false)
+  .help('help')
+  .argv
+
+const base = argv.base;
+const compare = argv.compare;
+
+function fetchJSON(host, path) {
+  return new Promise((resolve, reject) => {
+    let data = '';
+
+    require('https').get({
+      host,
+      path,
+      headers: { 'User-Agent': 'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0)' },
+    }).on('response', response => {
+      response.on('data', chunk => {
+        data += chunk;
+      });
+
+      response.on('end', () => {
+        try {
+          const json = JSON.parse(data);
+          resolve(json);
+        } catch (e) {
+          reject(e);
+        }
+      });
+
+      response.on('error', error => {
+        reject(error);
+      });
+    });
+  });
+}
+
+function filterCICommits(commits) {
+  return commits.filter(item => {
+    const text = item.commit.message.toLowerCase();
+    return !(text.includes('travis') || text.includes('circleci') || text.includes('circle ci') || text.includes('bump version numbers'));
+  });
+}
+function filterRevertCommits(commits) {
+  let revertCommits = [];
+  const revertCommitIndicators = ['revert "', 'back out "'];
+  const filteredCommits = commits.filter(item => {
+    let text = item.commit.message.split('\n')[0].toLowerCase();
+    if(revertCommitIndicators.some(indicator => text.includes(indicator))) {
+      revertCommitIndicators.forEach(indicator => {
+        text = text.replace(indicator, "");
+      });
+      revertCommits.push(text);
+      return false;
+    }
+    return true;
+  }).filter(item => {
+    let text = item.commit.message.split('\n')[0].toLowerCase();
+    revertCommits.forEach(revertCommit => {
+      if(levenshtein.get(text, revertCommit) < 0.5 * revertCommit.length) {
+        revertCommits = revertCommits.filter(function(e) { return e !== revertCommit });
+        return false;
+      }
+    });
+    return true;
+  });
+  if(revertCommits.length > 0) console.warn("Was unable to find the mate for the following revert commits: " + revertCommits + "; you will need to manually remove this from below.");
+  return filteredCommits;
+}
+
+function isAndroidCommit(change) {
+  return /\b(android|java)\b/i.test(change) || /android/i.test(change);
+}
+
+function isIOSCommit(change) {
+  return /\b(ios|xcode|swift|objective-c|iphone|ipad)\b/i.test(change) || /ios\b/i.test(change) || /\brct/i.test(change);
+}
+
+function isAdded(change) {
+  return /\b(add|adds|added|enhancement)\b/i.test(change);
+}
+
+function isChanged(change) {
+  return /\b(changes|changed)\b/i.test(change);
+}
+
+function isDeprecated(change) {
+    return /\b(deprecated|deprecate)\b/i.test(change);
+}
+
+function isRemoved(change) {
+    return /\b(remove|removed)\b/i.test(change);
+}
+
+function isFixed(change) {
+    return /\b(fix|fixes|fixed)\b/i.test(change);
+}
+
+function isSecurity(change) {
+    return /\b(security)\b/i.test(change);
+  }
+
+function getChangeMessage(item) {
+  const commitMessage = item.commit.message.split('\n');
+  const entry = commitMessage.find(a => /\[ios\]|\[android\]|\[general\]/i.test(a)) || commitMessage[0];
+  const authorSection = `([${item.sha.slice(0, 7)}](https://github.com/facebook/react-native/commit/${item.sha.slice(0, 7)})${item.author ? ' by [@' + item.author.login + '](https://github.com/' + item.author.login + ')' : ''})`;
+  return `- ${entry} ${authorSection}`;
+}
+
+function getChangelogDesc(commits) {
+  const acc = {
+    added: { android: [], ios: [], general: [] },
+    changed: { android: [], ios: [], general: [] },
+    deprecated: { android: [], ios: [], general: [] },
+    removed: { android: [], ios: [], general: [] },
+    fixed: { android: [], ios: [], general: [] },
+    security: { android: [], ios: [], general: [] },
+    unknown: { android: [], ios: [], general: [] },
+  };
+
+  commits.forEach(item => {
+    const change = item.commit.message;
+    const message = getChangeMessage(item);
+
+    if (isAdded(change)) {
+      if (isAndroidCommit(change)) {
+        acc.added.android.push(message);
+      } else if (isIOSCommit(change)) {
+        acc.added.ios.push(message);
+      } else {
+        acc.added.general.push(message);
+      }
+    } else if (isChanged(change)) {
+        if (isAndroidCommit(change)) {
+          acc.changed.android.push(message);
+        } else if (isIOSCommit(change)) {
+          acc.changed.ios.push(message);
+        } else {
+          acc.changed.general.push(message);
+        }
+      } else if (isDeprecated(change)) {
+        if (isAndroidCommit(change)) {
+          acc.deprecated.android.push(message);
+        } else if (isIOSCommit(change)) {
+          acc.deprecated.ios.push(message);
+        } else {
+          acc.deprecated.general.push(message);
+        }
+      } else if (isRemoved(change)) {
+        if (isAndroidCommit(change)) {
+          acc.removed.android.push(message);
+        } else if (isIOSCommit(change)) {
+          acc.removed.ios.push(message);
+        } else {
+          acc.removed.general.push(message);
+        }
+      } else if (isFixed(change)) {
+        if (isAndroidCommit(change)) {
+          acc.fixed.android.push(message);
+        } else if (isIOSCommit(change)) {
+          acc.fixed.ios.push(message);
+        } else {
+          acc.fixed.general.push(message);
+        }
+      } else if (isSecurity(change)) {
+        if (isAndroidCommit(change)) {
+          acc.security.android.push(message);
+        } else if (isIOSCommit(change)) {
+          acc.security.ios.push(message);
+        } else {
+          acc.security.general.push(message);
+        }
+      } else {
+      if (isAndroidCommit(change)) {
+        acc.unknown.android.push(message);
+      } else if (isIOSCommit(change)) {
+        acc.unknown.ios.push(message);
+      } else {
+        acc.unknown.general.push(message);
+      }
+    }
+  });
+
+  return acc;
+}
+
+function buildMarkDown(data) {
+  return `
+
+## [${argv.compare}.0]
+
+### Added
+
+${data.added.general.join('\n')}
+
+#### Android specific
+
+${data.added.android.join('\n')}
+
+#### iOS specific
+
+${data.added.ios.join('\n')}
+
+### Changed
+
+${data.changed.general.join('\n')}
+
+#### Android specific
+
+${data.changed.android.join('\n')}
+
+#### iOS specific
+
+${data.changed.ios.join('\n')}
+
+### Deprecated
+
+${data.deprecated.general.join('\n')}
+
+#### Android specific
+
+${data.deprecated.android.join('\n')}
+
+#### iOS specific
+
+${data.deprecated.ios.join('\n')}
+
+### Removed
+
+${data.removed.general.join('\n')}
+
+#### Android specific
+
+${data.removed.android.join('\n')}
+
+#### iOS specific
+
+${data.removed.ios.join('\n')}
+
+### Fixed
+
+${data.fixed.general.join('\n')}
+
+#### Android specific
+
+${data.fixed.android.join('\n')}
+
+#### iOS specific
+
+${data.fixed.ios.join('\n')}
+
+### Security
+
+${data.security.general.join('\n')}
+
+#### Android specific
+
+${data.security.android.join('\n')}
+
+#### iOS specific
+
+${data.security.ios.join('\n')}
+
+### Unknown
+
+${data.unknown.general.join('\n')}
+
+#### Android Unknown
+
+${data.unknown.android.join('\n')}
+
+#### iOS Unknown
+
+${data.unknown.ios.join('\n')}
+`;
+}
+
+fetchJSON('api.github.com', '/repos/facebook/react-native/compare/' + base + '...' + compare)
+  .then(data => data.commits)
+  .then(filterCICommits)
+  .then(filterRevertCommits)
+  .then(getChangelogDesc)
+  .then(buildMarkDown)
+  .then(data => console.log(data))
+  .catch(e => console.error(e));