より良いドキュメンテーションに向けて

優れた開発者体験の要素の一つは、優れたドキュメントがあることです。良いドキュメントを作成するには多くの要素が関係します。理想的なドキュメントは、簡潔で、役に立ち、正確で、完全で、そして楽しいものです。最近、私たちは皆さんのフィードバックに基づいてドキュメントを改善するために懸命に取り組んでおり、これまでに改善した点の一部を共有したいと思います。

インラインの例

新しいライブラリ、新しいプログラミング言語、または新しいフレームワークを学ぶとき、最初に少しコードを書いて試してみて、それが動作するかどうかを確認する、そしてそれが**動作する**という美しい瞬間があります。あなたは何か本物のものを作成したのです。私たちは、この直感的な体験をドキュメントに直接組み込みたいと考えました。このように

import React, { Component } from 'react';
import { AppRegistry, Text, View } from 'react-native';

class ScratchPad extends Component {
  render() {
    return (
      <View style={{flex: 1}}>
        <Text style={{fontSize: 30, flex: 1, textAlign: 'center'}}>
          Isn't this cool?
        </Text>
        <Text style={{fontSize: 100, flex: 1, textAlign: 'center'}}>
          👍
        </Text>
      </View>
    );
  }
}

AppRegistry.registerComponent('ScratchPad', () => ScratchPad);

Devin Abbott氏の協力のもと、react-native-web-playerモジュールを使用するこれらのインラインサンプルは、React Nativeの基本を学ぶのに最適な方法だと考えており、React Native開発者向けのチュートリアルを可能な限りこれらを使用するように更新しました。ぜひ試してみてください。もしサンプルコードのほんの少しの部分を変更したらどうなるか、ずっと知りたかったとしたら、これは試してみるのに本当に良い方法です。また、開発者ツールを構築していて、自分のサイトにライブのReact Nativeサンプルを表示したい場合は、react-native-web-playerを使用するとそれが簡単になります。

コアシミュレーションエンジンは、Nicolas Gallagher氏のreact-native-webプロジェクトによって提供されており、TextやViewのようなReact Nativeコンポーネントをウェブ上で表示する方法を提供します。コードベースの大部分を共有するモバイルおよびウェブ体験を構築することに興味がある場合は、react-native-webをチェックしてみてください。

より良いガイド

React Nativeの一部の機能には複数の実現方法があり、より良いガイダンスを提供すべきだというフィードバックをいただきました。

異なるアプローチを比較し、Navigator、NavigatorIOS、NavigationExperimentalのうちどれを使用すべきかをアドバイスする新しいナビゲーションガイドができました。中期的には、これらのインターフェースの改善と統合に取り組んでいます。短期的には、より良いガイドが皆さんの生活を楽にすることを願っています。

ボタンのようなインターフェースを作成する基本的な方法と、タッチイベントを処理するさまざまな方法を簡潔にまとめた、タッチ処理に関する新しいガイドも作成しました。

もう1つ取り組んだ分野はFlexboxです。これには、Flexboxでレイアウトを処理する方法とコンポーネントのサイズを制御する方法に関するチュートリアルが含まれています。また、地味ですが役立つと思われるReact Nativeのレイアウトを制御するすべてのプロパティのリストも含まれています。

はじめに

マシン上でReact Nativeの開発環境をセットアップし始めるときは、インストールと構成をいくつか実行する必要があります。インストールを本当に楽しくエキサイティングな体験にするのは難しいですが、少なくともできるだけ迅速かつ簡単に行うことはできます。

新しいGetting Startedワークフローを構築しました。これにより、開発に使用するオペレーティングシステムとモバイルオペレーティングシステムを事前に選択でき、すべてのセットアップ手順が一箇所に簡潔にまとめられます。また、すべてが機能することを確認し、すべての決定ポイントで明確な推奨事項があることを確認するために、インストールプロセス全体を検証しました。無実の同僚でテストした後、これは改善であると確信しています。

また、既存のアプリにReact Nativeを統合するためのガイドも作成しました。React Nativeを使用する最大のアプリの多く（Facebookアプリ自体など）は、アプリの一部をReact Nativeで構築し、残りの部分を通常の開発ツールを使用して構築しています。このガイドが、より多くの人々がこの方法でアプリを構築するのに役立つことを願っています。

皆様の助けが必要です

皆さんのフィードバックによって、私たちが何を優先すべきかを知ることができます。このブログ記事を読んで「より良いドキュメント？ふん。Xのドキュメントはまだひどいじゃないか！」と思う人もいるでしょう。それは素晴らしいことです。そのエネルギーが必要なのです。フィードバックの最適な方法は、フィードバックの種類によって異なります。

説明が不正確だったり、実際に動作しないコードなど、ドキュメントに誤りを見つけた場合は、課題を提出してください。「Documentation」というタグを付けて、適切な担当者に回されやすくしてください。

具体的な誤りではないが、ドキュメントの何かが根本的に分かりにくい場合は、GitHubの課題には適していません。代わりに、助けが必要なドキュメントの領域についてCannyに投稿してください。これは、ガイドの執筆のようなより一般的な作業を行う際に、私たちが優先順位を付けるのに役立ちます。

ここまで読んでいただき、React Nativeをご利用いただきありがとうございます！