Skip to content

Commit

Permalink
docs(en): merge reactjs.org into zh-hans @ bbea522 (reactjs#331)
Browse files Browse the repository at this point in the history
docs(en): merge reactjs.org into zh-hans @ bbea522
  • Loading branch information
QC-L committed Nov 12, 2019
2 parents 79c9a03 + 0705d22 commit 345bd18
Show file tree
Hide file tree
Showing 32 changed files with 311 additions and 928 deletions.
14 changes: 7 additions & 7 deletions content/blog/2019-10-22-react-release-channels.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Because the source of truth for React is our [public GitHub repository](https://

We would like to make it even easier for developers to test prerelease builds of React, so we're formalizing our process with three separate release channels.

## Release Channels
## Release Channels {#release-channels}

> The information in this post is also available on our [Release Channels](/docs/release-channels.html) page. We will update that document whenever there are changes to our release process.
Expand All @@ -29,15 +29,15 @@ All releases are published to npm, but only Latest uses [semantic versioning](/d

By publishing prereleases to the same registry that we use for stable releases, we are able to take advantage of the many tools that support the npm workflow, like [unpkg](https://unpkg.com) and [CodeSandbox](https://codesandbox.io).

### Latest Channel
### Latest Channel {#latest-channel}

Latest is the channel used for stable React releases. It corresponds to the `latest` tag on npm. It is the recommended channel for all React apps that are shipped to real users.

**If you're not sure which channel you should use, it's Latest.** If you're a React developer, this is what you're already using.

You can expect updates to Latest to be extremely stable. Versions follow the semantic versioning scheme. Learn more about our commitment to stability and incremental migration in our [versioning policy](/docs/faq-versioning.html).

### Next Channel
### Next Channel {#next-channel}

The Next channel is a prerelease channel that tracks the master branch of the React repository. We use prereleases in the Next channel as release candidates for the Latest channel. You can think of Next as a superset of Latest that is updated more frequently.

Expand All @@ -47,7 +47,7 @@ The degree of change between the most recent Next release and the most recent La

Releases in Next are published with the `next` tag on npm. Versions are generated from a hash of the build's contents, e.g. `0.0.0-1022ee0ec`.

#### Using the Next Channel for Integration Testing
#### Using the Next Channel for Integration Testing {#using-the-next-channel-for-integration-testing}

The Next channel is designed to support integration testing between React and other projects.

Expand All @@ -73,7 +73,7 @@ If you're the author of a third party React framework, library, developer tool,

A project that uses this workflow is Next.js. (No pun intended! Seriously!) You can refer to their [CircleCI configuration](https://github.com/zeit/next.js/blob/c0a1c0f93966fe33edd93fb53e5fafb0dcd80a9e/.circleci/config.yml) as an example.

### Experimental Channel
### Experimental Channel {#experimental-channel}

Like Next, the Experimental channel is a prerelease channel that tracks the master branch of the React repository. Unlike Next, Experimental releases include additional features and APIs that are not ready for wider release.

Expand All @@ -83,15 +83,15 @@ Experimental releases may be significantly different than releases to Next and L

Releases in Experimental are published with the `experimental` tag on npm. Versions are generated from a hash of the build's contents, e.g. `0.0.0-experimental-1022ee0ec`.

#### What Goes Into an Experimental Release?
#### What Goes Into an Experimental Release? {#what-goes-into-an-experimental-release}

Experimental features are ones that are not ready to be released to the wider public, and may change drastically before they are finalized. Some experiments may never be finalized -- the reason we have experiments is to test the viability of proposed changes.

For example, if the Experimental channel had existed when we announced Hooks, we would have released Hooks to the Experimental channel weeks before they were available in Latest.

You may find it valuable to run integration tests against Experimental. This is up to you. However, be advised that Experimental is even less stable than Next. **We do not guarantee any stability between Experimental releases.**

#### How Can I Learn More About Experimental Features?
#### How Can I Learn More About Experimental Features? {#how-can-i-learn-more-about-experimental-features}

Experimental features may or may not be documented. Usually, experiments aren't documented until they are close to shipping in Next or Stable.

Expand Down

Large diffs are not rendered by default.

5 changes: 0 additions & 5 deletions content/community/complementary-tools.it-IT.md

This file was deleted.

5 changes: 0 additions & 5 deletions content/community/complementary-tools.ko-KR.md

This file was deleted.

5 changes: 0 additions & 5 deletions content/community/complementary-tools.zh-CN.md

This file was deleted.

19 changes: 0 additions & 19 deletions content/community/conferences.it-IT.md

This file was deleted.

19 changes: 0 additions & 19 deletions content/community/conferences.ko-KR.md

This file was deleted.

29 changes: 0 additions & 29 deletions content/community/conferences.zh-CN.md

This file was deleted.

5 changes: 0 additions & 5 deletions content/community/examples.it-IT.md

This file was deleted.

5 changes: 0 additions & 5 deletions content/community/examples.ko-KR.md

This file was deleted.

5 changes: 0 additions & 5 deletions content/community/examples.zh-CN.md

This file was deleted.

2 changes: 2 additions & 0 deletions content/community/external-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,3 +17,5 @@ There are many wonderful curated resources the React community has put together.
- [Awesome React Components](https://github.com/brillout/awesome-react-components) - A curated list of React components.

- [Awesome React Talks](https://github.com/tiaanduplessis/awesome-react-talks) - A curated list of React talks.

- [Hero35 React Hub](https://hero35.com/stack/react) - A website with _all_ React conferences and talks, categorized & curated.
20 changes: 0 additions & 20 deletions content/community/nav.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,23 +18,3 @@
title: 视频
- id: external-resources
title: 外部资源
- title: 工具
items:
- id: debugging-tools
title: 调试
- id: component-workbenches
title: 组件工具集
- id: jsx-integrations
title: JSX 集成
- id: starter-kits
title: 脚手架
- id: routing
title: 路由
- id: model-management
title: 模型管理
- id: data-fetching
title: 数据交互
- id: ui-components
title: UI 组件库
- id: misc
title: 杂项
15 changes: 0 additions & 15 deletions content/community/tools-comp-workbenches.md

This file was deleted.

12 changes: 0 additions & 12 deletions content/community/tools-data-fetching.md

This file was deleted.

8 changes: 0 additions & 8 deletions content/community/tools-debugging.md

This file was deleted.

53 changes: 0 additions & 53 deletions content/community/tools-jsx.md

This file was deleted.

19 changes: 0 additions & 19 deletions content/community/tools-misc.md

This file was deleted.

0 comments on commit 345bd18

Please sign in to comment.