Merge pull request #342 from reactjs/legacy-merge

Create legacy docs branch

Author: gaearon

.circleci/config.yml

@@ -1,5 +1,8 @@
 node_modules/*
 
+# Skip beta
+beta/*
+
 # Ignore markdown files and examples
 content/*
 

.eslintignore

@@ -1,5 +1,6 @@
 [ignore]
 
+<PROJECT_ROOT>/beta/.*
 <PROJECT_ROOT>/content/.*
 <PROJECT_ROOT>/node_modules/.*
 <PROJECT_ROOT>/public/.*

.flowconfig

@@ -4,7 +4,7 @@ Thank you for the PR! Contributors like you keep React awesome!
 
 Please see the Contribution Guide for guidelines:
 
-https://github.com/reactjs/reactjs.org/blob/main/CONTRIBUTING.md
+https://github.com/reactjs/legacy.reactjs.org/blob/main/CONTRIBUTING.md
 
 If your PR references an existing issue, please add the issue number below
 

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,27 @@
+name: Lint / Flow check
+
+on:
+  push:
+    branches:
+      - main # change this if your default branch is named differently
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    name: Lint on node 12.x and ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v1
+      - name: Use Node.js 12.x
+        uses: actions/setup-node@v1
+        with:
+          node-version: 12.x
+
+      - name: Install deps and build (with cache)
+        uses: bahmutov/npm-install@v1.7.10
+
+      - name: Lint codebase
+        run: yarn ci-check

.github/workflows/nodejs.yml

@@ -3,5 +3,5 @@
 .idea
 .history
 node_modules
-public
+/public
 yarn-error.log

.gitignore

@@ -1 +1 @@
-12.16.1
+12.22.0

.nvmrc

@@ -1,70 +1,20 @@
-# vi.reactjs.org
+# vi.legacy.reactjs.org
 
-This repo contains the source code and documentation powering [vi.reactjs.org](https://reactjs.org/).
+This repo contains the source code and documentation powering [vi.legacy.reactjs.org](https://vi.legacy.reactjs.org/).
 
-## Getting started
+## Not actively maintained
 
-### Prerequisites
+This site is archived and not maintained. For new React docs, go to [vi.react.dev](https://vi.react.dev) ([repository](https://github.com/reactjs/vi.react.dev)).
 
-1. Git
-1. Node: any 12.x version starting with v12.0.0 or greater
-1. Yarn: See [Yarn website for installation instructions](https://yarnpkg.com/lang/en/docs/install/)
-1. A fork of the repo (for any contributions)
-1. A clone of the [vi.reactjs.org repo](https://github.com/reactjs/vi.reactjs.org) on your local machine
+## Installation
 
-### Installation
-
-1. `cd vi.reactjs.org` to go into the project root
+1. `cd legacy.reactjs.org` to go into the project root
 1. `yarn` to install the website's npm dependencies
 
-### Running locally
+## Running locally
 
-1. `yarn dev` to start the hot-reloading development server (powered by [Gatsby](https://www.gatsbyjs.org))
+1. `yarn dev` to start the development server (powered by [Gatsby](https://www.gatsbyjs.org))
 1. `open http://localhost:8000` to open the site in your favorite browser
 
-## Contributing
-
-### Guidelines
-
-The documentation is divided into several sections with a different tone and purpose. If you plan to write more than a few sentences, you might find it helpful to get familiar with the [contributing guidelines](https://github.com/reactjs/reactjs.org/blob/main/CONTRIBUTING.md#guidelines-for-text) for the appropriate sections.
-
-### Create a branch
-
-1. `git checkout main` from any folder in your local `vi.reactjs.org` repository
-1. `git pull origin main` to ensure you have the latest main code
-1. `git checkout -b the-name-of-my-branch` (replacing `the-name-of-my-branch` with a suitable name) to create a branch
-
-### Make the change
-
-1. Follow the ["Running locally"](#running-locally) instructions
-1. Save the files and check in the browser
-  1. Changes to React components in `src` will hot-reload
-  1. Changes to markdown files in `content` will hot-reload
-  1. If working with plugins, you may need to remove the `.cache` directory and restart the server
-
-### Test the change
-
-1. If possible, test any visual changes in all latest versions of common browsers, on both desktop and mobile.
-1. Run `yarn check-all` from the project root. (This will run Prettier, ESLint, and Flow.)
-
-### Push it
-
-1. `git add -A && git commit -m "My message"` (replacing `My message` with a commit message, such as `Fix header logo on Android`) to stage and commit your changes
-1. `git push my-fork-name the-name-of-my-branch`
-1. Go to the [vi.reactjs.org repo](https://github.com/reactjs/vi.reactjs.org) and you should see recently pushed branches.
-1. Follow GitHub's instructions.
-1. If possible, include screenshots of visual changes. A [Netlify](https://www.netlify.com/) build will also be automatically created once you make your PR so other people can see your change.
-
-## Translation
-
-If you are interested in translating `reactjs.org`, please see the current translation efforts at [translations.reactjs.org](https://translations.reactjs.org/).
-
-
-If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg).
-
-## Troubleshooting
-
-- `yarn reset` to clear the local cache
-
 ## License
-Content submitted to [reactjs.org](https://reactjs.org/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](https://github.com/open-source-explorer/reactjs.org/blob/main/LICENSE-DOCS.md) file.
+Content at [vi.legacy.reactjs.org](https://vi.legacy.reactjs.org/) is CC-BY-4.0 licensed, as found in the [LICENSE-DOCS.md](LICENSE-DOCS.md) file.

README.md

@@ -31,6 +31,12 @@ flarnie:
 gaearon:
   name: Dan Abramov
   url: https://twitter.com/dan_abramov
+gsathya:
+  name: Sathya Gunasekaran
+  url: https://twitter.com/_gsathya
+huxpro:
+  name: Xuan Huang
+  url: https://twitter.com/Huxpro
 jaredly:
   name: Jared Forsyth
   url: https://twitter.com/jaredforsyth
@@ -46,6 +52,15 @@ jingc:
 josephsavona:
   name: Joseph Savona
   url: https://twitter.com/en_JS
+joshcstory:
+  name: Josh Story
+  url: https://twitter.com/joshcstory
+jtannady:
+  name: Jesslyn Tannady
+  url: https://twitter.com/jtannady
+kassens:
+  name: Jan Kassens
+  url: https://twitter.com/kassens
 keyanzhang:
   name: Keyan Zhang
   url: https://twitter.com/keyanzhang
@@ -54,13 +69,16 @@ kmeht:
   url: https://github.com/kmeht
 laurentan:
   name: Lauren Tan
-  url: https://twitter.com/sugarpirate_
+  url: https://twitter.com/potetotes
 LoukaN:
   name: Lou Husson
   url: https://twitter.com/loukan42
 lunaruan:
   name: Luna Ruan
   url: https://twitter.com/lunaruan
+mengdichen:
+  name: Mengdi Chen
+  url: https://twitter.com/mengdi_en
 matthewjohnston4:
   name: Matthew Johnston
   url: https://github.com/matthewathome
@@ -73,9 +91,15 @@ petehunt:
 rachelnabors:
   name: Rachel Nabors
   url: https://twitter.com/rachelnabors
+reactteam:
+  name: The React Team
+  url: https://reactjs.org/community/team.html
 rickhanlonii:
   name: Rick Hanlon
   url: https://twitter.com/rickhanlonii
+robertzhang:
+  name: Robert Zhang
+  url: https://twitter.com/jiaxuanzhang01
 schrockn:
   name: Nick Schrock
   url: https://twitter.com/schrockn

content/authors.yml

@@ -3,6 +3,12 @@ title: Tích hợp JSFiddle
 author: [vjeux]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 [JSFiddle](https://jsfiddle.net) vừa mới thông báo hỗ trợ cho React. Đây là một tin thú vị vì nó giúp cho việc cộng tác với các đoạn code trở nên dễ dàng hơn rất nhiều. Bạn có thể làm việc với **[nền tảng React JSFiddle](http://jsfiddle.net/vjeux/kb3gN/)**, sửa đổi và chia sẻ nó! Một [fiddle không cần JSX](http://jsfiddle.net/vjeux/VkebS/) cũng đã có.
 
 

content/blog/2013-06-02-jsfiddle-integration.md

@@ -3,6 +3,12 @@ title: Tại sao chúng tôi xây dựng React?
 author: [petehunt]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 Có rất nhiều thư viện JavaScript MVC. Tại sao chúng tôi xây dựng React và tại sao bạn muốn sử dụng nó?
 
 ## React không phải là một MVC framework. {#react-isnt-an-mvc-framework}

content/blog/2013-06-05-why-react.md

@@ -3,6 +3,12 @@ title: "Community Round-up #1"
 author: [vjeux]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 React was open sourced two weeks ago and it's time for a little round-up of what has been going on.
 
 ## Khan Academy Question Editor {#khan-academy-question-editor}

content/blog/2013-06-12-community-roundup.md

@@ -3,6 +3,12 @@ title: "Community Round-up #2"
 author: [vjeux]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 Since the launch we have received a lot of feedback and are actively working on React 0.4. In the meantime, here are the highlights of this week.
 
 ## Some quick thoughts on React {#some-quick-thoughts-on-react}

content/blog/2013-06-19-community-roundup-2.md

@@ -3,6 +3,12 @@ title: "React v0.3.3"
 author: [zpao]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 Chúng tôi có rất nhiều thứ tuyệt vời sắp ra mắt trong phiên bản v0.4, nhưng trong thời gian chờ đợi, chúng tôi sẽ phát
 hành phiên bản v0.3.3. Bản phát hành này giải quyết một số vấn đề nhỏ mà mọi người đang gặp phải và đơn giản hóa các
 công cụ của chúng tôi để giúp chúng dễ sử dụng hơn.

content/blog/2013-06-21-react-v0-3-3.md

@@ -3,6 +3,12 @@ title: "Community Round-up #3"
 author: [vjeux]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 The highlight of this week is that an interaction-heavy app has been ported to React. React components are solving issues they had with nested views.
 
 ## Moving From Backbone To React {#moving-from-backbone-to-react}

content/blog/2013-06-27-community-roundup-3.md

@@ -3,6 +3,12 @@ title: "New in React v0.4: Autobind by Default"
 author: [zpao]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 React v0.4 is very close to completion. As we finish it off, we'd like to share with you some of the major changes we've made since v0.3. This is the first of several posts we'll be making over the next week.
 
 

content/blog/2013-07-02-react-v0-4-autobind-by-default.md

@@ -3,6 +3,12 @@ title: "Community Round-up #4"
 author: [vjeux]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 React reconciliation process appears to be very well suited to implement a text editor with a live preview as people at Khan Academy show us.
 
 ## Khan Academy {#khan-academy}

content/blog/2013-07-03-community-roundup-4.md

@@ -3,6 +3,12 @@ title: "New in React v0.4: Prop Validation and Default Values"
 author: [zpao]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 Many of the questions we got following the public launch of React revolved around `props`, specifically that people wanted to do validation and to make sure their components had sensible defaults.
 
 

content/blog/2013-07-11-react-v0-4-prop-validation-and-default-values.md

@@ -3,6 +3,12 @@ title: "React v0.4.0"
 author: [zpao]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 Over the past 2 months we've been taking feedback and working hard to make React even better. We fixed some bugs, made some under-the-hood improvements, and added several features that we think will improve the experience developing with React. Today we're proud to announce the availability of React v0.4!
 
 

content/blog/2013-07-17-react-v0-4-0.md

@@ -3,6 +3,12 @@ title: "Community Round-up #5"
 author: [vjeux]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 We launched the [React Facebook Page](https://www.facebook.com/react) along with the React v0.4 launch. 700 people already liked it to get updated on the project :)
 
 ## Cross-browser onChange {#cross-browser-onchange}

content/blog/2013-07-23-community-roundup-5.md

@@ -3,6 +3,12 @@ title: "React v0.4.1"
 author: [zpao]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 React v0.4.1 là một thay đổi nhỏ, hầu hết bao gồm các bản sửa lỗi về tính đúng đắn. Một số đoạn mã đã được cấu trúc lại bên trong nhưng những thay đổi đó không ảnh hưởng đến bất kỳ API công khai nào của chúng tôi.
 
 

content/blog/2013-07-26-react-v0-4-1.md

@@ -3,6 +3,12 @@ title: "Use React and JSX in Ruby on Rails"
 author: [zpao]
 ---
 
+<div class="scary">
+
+> This blog site has been archived. Go to [react.dev/blog](https://react.dev/blog) to see the recent posts.
+
+</div>
+
 Today we're releasing a gem to make it easier to use React and JSX in Ruby on Rails applications: [react-rails](https://github.com/facebook/react-rails).