Skip to content

Commit 91ce6bc

Browse files
author
Riccardo
authored
fix: Improve wording for iOS getting started (facebook#3334)
1 parent b5f5b5a commit 91ce6bc

File tree

3 files changed

+13
-5
lines changed

3 files changed

+13
-5
lines changed

docs/_getting-started-macos-ios.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,8 @@ If you have already installed Node on your system, make sure it is Node 14 or ne
2121

2222
### Ruby
2323

24+
[Ruby](https://www.ruby-lang.org/en/) is a general-purpose programming language. React Native uses in some scripts related to the iOS dependency management. As every programming language, there are different versions of Ruby that have been developed during the years.
25+
2426
React Native uses a `.ruby-version` file to make sure that your version of Ruby is aligned with what is needed. Currently, macOS 12.5.1 is shipped with Ruby 2.6.8, which is **not** what is required by React Native. Our suggestion is to install a Ruby version manager and to install the proper version of Ruby in your system.
2527

2628
Some common Ruby version manager are:
@@ -38,9 +40,11 @@ ruby --version
3840

3941
React Native uses [this version](https://github.com/facebook/react-native/blob/main/template/_ruby-version) of Ruby. You can also find which version your specific project needs in the `.ruby-version` file at root of your RN project.
4042

41-
### Bundler
43+
### Ruby's Bundler
44+
45+
Ruby uses the concept of **gems** to handle its own dependencies. You can think of a gem as a package in NPM, a formula in Homebrew or a single pod in Cocoapods.
4246

43-
[Bundler](https://bundler.io/) is a Ruby gem that helps managing the Ruby dependencies of your project. We need Ruby to install Cocoapods and using Bundler will make sure that all the dependencies are aligned and that the project works properly.
47+
Ruby's [Bundler](https://bundler.io/) is a Ruby gem that helps managing the Ruby dependencies of your project. We need Ruby to install Cocoapods and using Bundler will make sure that all the dependencies are aligned and that the project works properly.
4448

4549
If you want to learn more about why we need this tool, you can read [this article](https://bundler.io/guides/rationale.html#bundlers-purpose-and-rationale).
4650

@@ -62,7 +66,7 @@ To install a simulator, open <strong>Xcode > Preferences...</strong> and select
6266

6367
#### CocoaPods
6468

65-
[CocoaPods](https://cocoapods.org/) is built with Ruby and it will be installable with the default Ruby available on macOS.
69+
[CocoaPods](https://cocoapods.org/) is one of the dependency management system available for iOS. It is built with Ruby and you can install it using the version of Ruby you configured with in the previous steps.
6670

6771
For more information, please visit [CocoaPods Getting Started guide](https://guides.cocoapods.org/using/getting-started.html).
6872

docs/the-new-architecture/backward-compatibility-fabric-components.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,13 @@ Creating a backward compatible Fabric Native Component lets your users continue
2424
1. Uniform the JavaScript API so that your user code won't need changes.
2525

2626
:::info
27+
2728
For the sake of this guide we're going to use the following **terminology**:
2829

2930
- **Legacy Native Components** - To refer to Components which are running on the old React Native architecture.
3031
- **Fabric Native Components** - To refer to Components which have been adapted to work well with the New Native Renderer, Fabric. For brevity you might find them referred as **Fabric Components**.
31-
:::
32+
33+
:::
3234

3335
<BetaTS />
3436

docs/the-new-architecture/backward-compatibility-turbomodules.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,13 @@ Creating a backward compatible TurboModule lets your users continue to leverage
2424
1. Uniform the JavaScript API so that your user code won't need changes.
2525

2626
:::info
27+
2728
For the sake of this guide we're going to use the following **terminology**:
2829

2930
- **Legacy Native Modules** - To refer to Modules which are running on the old React Native architecture.
3031
- **Turbo Native Modules** - To refer to Modules which have been adapted to work well with the New Native Module System. For brevity you might find them referred as **Turbo Modules**.
31-
:::
32+
33+
:::
3234

3335
<BetaTS />
3436

0 commit comments

Comments
 (0)