search

facebook / react-native-website

The React Native website and docs
https://reactnative.dev
MIT License
1.96k stars 4.39k forks source link

📘 What would you like to learn about React Native? #917

Closed cpojer closed 5 years ago

cpojer commented 5 years ago

We are planning on revamping our guides for React Native: https://facebook.github.io/react-native/docs/getting-started

Many of the existing guides and the overall flow of the documentation were written in 2015 and do not reflect well what it is like to build apps with React Native in 2019. We have an idea of what we'd like to improve and will share a plan soon but we'd like to hear from the community what they'd like to see in the React Native documentation:

If you have recently learned how to use React Native or if you imagine learning React Native from scratch and would like to help, here are some questions to get started:

Feel free to reply here with your suggestions and ideas! Thank you 🙏

Divine1 commented 5 years ago

i'm not able to find docs on the android/ios sdk versions & nodejs,npm versions supported by each expo releases.

i'm starting to think below issue is because of expo-cli not being compatible with node 10.15.3, because the expo-cli installed without any issue in node 8.11. . i didnot check in node 9.. i think Starting ios simulator on a expo project took 10 years out of my life span but still i'm not able to make it work. More details on "this setup" would be helpful. i would be a lot happier if everything starts to work as explained in the doc. Everything seems to be so easy while reading the docs

https://github.com/expo/expo-cli/issues/412

if there is any docs available already for this then please point me to it

does push notifications built using expo really work on IOS without any developer certificate?

yousefelgoharyx commented 5 years ago

mmmm, ig better UI would be great

ecreeth commented 5 years ago

What I would like more is to improve the documentation, more components and a proper implementation of the navigation.

What parts that you discovered that were important were missing from the website?

What things would you remove from the website because they are outdated and confusing?

I consider that the OBSOLETE components should be eliminated

What are the most useful resources you used to learn React Native?

orta commented 5 years ago

I learned by diving through the f8 app via https://makeitopen.com - I think a video series where you guide someone through building a small(er) and self contained app, wrapping up with showing how to write some tests and feel comfortable looking at it in iOS/Android sims.

Something like this probably already exists, but could be re-done with some more production values and be classed as official

tsdmrfth commented 5 years ago

When i new to React Native, as i remember i was very stuggling when i try to make some components that's why i would like to see working examples in both android and iOS with the example codes for components section especially.

Steffi3rd commented 5 years ago

What I would like more is to improve the documentation, more components and a proper implementation of the navigation.

What parts that you discovered that were important were missing from the website?

What things would you remove from the website because they are outdated and confusing?

Which pages could use more details or rewrite?

Internal React Native solutions became Community solutions still must have a full detail documentation (Like react-navigation).

Some iOS 12 features like Large Header should be available right in this documentation.

What are the most useful resources you used to learn React Native?

What is the ideal flow to learn React Native?

I was easier for me to learn React Native because I already new ReactJS. And I was waiting for Hooks before starting React Native.

Anyway, thanks a lot for all of this guys! Keep going, it's amazing!

saxenanickk commented 5 years ago

There has to be some good documentation on ART.

pie6k commented 5 years ago

I've 'wasted' literally 1000's of lines of code because I didn't know about LayoutAnimation and I was creating complex animations (like reordering, unmounting) myself. I know it's my fault but it's so useful that it could be more exposed (as ex-web dev I didn't expect such magic like layout animations to be possible).

Maybe something like 'if you're web dev - this is MUST READ for you'

Also I was a bit scared to use 'Pods' for iOS at start. I was like 'no no no, I want ol' good js and go away with anything ios-ish'. When project got a bit complex, things got hairy and I eventually switched to Pods becasue I had senior iOS devs in the same room. It could also be a bit more exposed

glauberfc commented 5 years ago

Which parts that you found out were important were missing from the website?

  1. You could add more details on Contributing docs section, teaching people how use RNTester.
  2. I think that will be great if you teach people how Google Play and App Store works, and how deploy an app these stores.
  3. It would be nice if there is a section with a tutorial like makeitopen.
ghmeec commented 5 years ago

Adding App testing in real devices such as via expo, would be great

rrramanan commented 5 years ago

• Important that missing from website?

AndreiCalazans commented 5 years ago

Which parts that you found out were important were missing from the website?

Which docs were really confusing and hard to understand?

What are the most helpful resources you used to learn React Native? Tutorials. Currently inside the Basics sections we have small tutorials covering separate parts, beyond this, It would add value to the documentation if some tutorials covering more advanced scenarios were added, e.g. Building a complete layout, Making a news feed with details page, Debugging a native issue, Adding a native module to your App, Make a clone of something which uses different APIs. (I know some of these tutorials are covered by the community, however, most beginners have a hard time finding these resources we could add links to them in the more resources page.)

How would you change the guides section on the website? What is the ideal flow to learn React Native? Which things do you think should be taught in which order?

**The Basics**
* Getting Started
* Learn the Basics
* Getting serious  // In here we could build something more real world instead of a Hello World App. 
* Props
* State
* Style
* Height and Width
...
amielmon commented 5 years ago

More documentation on event listeners!! More specifically scrolling actions.

Andarius commented 5 years ago

More documentation on flexbox like the one here.

Some documentation on testing could be nice (with a simple example using Jest and optionally other libs like Enzyme).

Some links to get started with RN using Typescript (like here)

ecreeth commented 5 years ago

More documentation on flexbox like the one here.

This is the best place for learn Flexbox https://yogalayout.com/

Andarius commented 5 years ago

More documentation on flexbox like the one here.

This is the best place for learn Flexbox https://yogalayout.com/

I prefer to have a quick overview like they have, you can quickly see what you need flexbox.png flexbox2.png flexbox3.png

e-molochko commented 5 years ago

Please, add more detailed description for component's/method's properties and their descriptions, add some sections to navigation(for easier access to the needed info). Mb some best practices for debugging, setting up android/ios application Icons, splashscreens

CodingItWrong commented 5 years ago

I'd love a page with quicker access to the docs for each component. Usually when i go to the docs I want to look up a specific component, but I have to scroll down in the sidebar to get to the Components section. If there was a Components or API page that just had those Components as the only things in the sidebar, that'd make navigation quicker. Kind of like http://api.emberjs.com/ember/release

sunday58 commented 5 years ago

I did love to see more images on the documentation, cause image explains practically than just text..

And more explained documentation on intent to make your app access other default apps on your phone..example; Camera, gallery, musicplayer etc.

tiancihe commented 5 years ago

I learned by diving through the f8 app via https://makeitopen.com - I think a video series where you guide someone through building a small(er) and self contained app, wrapping up with showing how to write some tests and feel comfortable looking at it in iOS/Android sims.

Something like this probably already exists, but could be re-done with some more production values and be classed as official

IMO, detailed docs are way more better than videos. So, my suggestion is to focus the effort on the doc rather than videos, and maybe a whole lot more detail on how to set up properly, maybe even how to set up for react-native-windows.

dev6james commented 5 years ago

This comes to mind immediately (LayoutAnimation) https://github.com/facebook/react-native-website/issues/889

Beyond that, more on the native debbuging and profiling experience. This tiny amount in the docs makes a new RN dev feel hopeless the second they run into a tricky native issue. Even pointing to guides in the android and iOS docs would be handy if anything more is considered out of scope. But honestly I think small guides on basic Xcode and Android Studio debugging would be worthwhile.

tijs commented 5 years ago

I would love to see a guide on packaging up react native code as re-usable NPM packages. There are some short references to create-library but no step by step reference. Ideally this would cover:

ramyareye commented 5 years ago

First as a web developer I think I'm happy that I started with CRNA instead of expo! Why? cause it forced me to dive in and learn faster, I don't know why but still I can't find reason to go with Expo. I think working on react-native requires knowledge about native codes.

Second I think there should be a complete guide to start with Visual Studio Code, it saves bunch of time.

Third is about learning about layouts, what better than https://flexboxfroggy.com/ to suggest ?

Fourth is about React and React Native. I saw people started directly with RN with no React Knowledge. So there should be a guide to have a fast course on React and to see what's going on! I saw people who were trying to find some guid for Redux on RN! There should be smart course for beginners like this.

Regards

Fausto95 commented 5 years ago

Well documented native modules(UI components also) creation with Swift and Kotlin

royeden commented 5 years ago

My suggestion is to add more examples whenever possible, at least for common usage.

We absolutely need a scroll back to top button on the page. Or at least a button that goes straight to the components props index again.

michalchudziak commented 5 years ago

I think a bit deeper documentation of React Native's native classes might be helpful, especially when it comes to integration with native apps. I've had to figure out a lot by scouring through the codebase, perhaps with well-documented classes, the entry level would decrease :)

pavermakov commented 5 years ago

It would be nice to have more info about how the AppState works in react-native. For example, how it behaves when native popups show up on android and the AppState changes all of a sudden. I have no prior experience with java, so I was frustrated when I first encountered this.

Also, it would be nice to include screenshots for all available components.

cpojer commented 5 years ago

Thanks everyone for all of your suggestions. I now created an umbrella task to track the website rewrite: https://github.com/facebook/react-native-website/issues/929

We need a ton of help to make this happen. If you are interested, check out the umbrella issue and send some PRs :)