-
-
Notifications
You must be signed in to change notification settings - Fork 654
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: Add more detail and improve readability. #328
Conversation
Add more detail to the developer guide for new contributors.
1e248c0
to
6f1f461
Compare
Add more whitespace to make README.md more readable.
6f1f461
to
f37c9eb
Compare
|
||
## Running on an iOS device | ||
1. [Set up the dev environment](#setting-up-a-dev-environment) | ||
2. Connect your iOS device | ||
3. Within the repo, `$ open ios/ZulipMobile.xcodeproj/` to open Xcode | ||
4. Select your device as the `build target` (from [this guide](https://facebook.github.io/react-native/docs/running-on-device-ios.html)) | ||
5. Hit the `build and run` button | ||
4. Change BundleIdentifier for both ZulipMobile and ZulipMobileTests to a |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This shouldn't be necessary anymore. @trueskawka do you still need to do this?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If it's your first time installing an app on an iOS device, you need to | ||
obtain Apple Developer credentials that will allow you to sign the app. | ||
Register at https://developer.apple.com. Then use your Apple ID in Xcode | ||
and choose it as your `Signing > Team` for both ZulipMobile and ZulipMobileTests. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe we should add something about not committing these changes to project.pbxproj
to diffs?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
yeah, making it more explicit will be useful :)
Just while we wait for the code in this package to be error-free when exact_by_default is enabled [1]. We plan to enable it for the RN v0.64 upgrade (zulip#4426). The PR is react-native-cameraroll/react-native-cameraroll#328. It's very possible that some of those object types would be better as exact instead of inexact. But: 1. Just getting the library to pass the implicit-inexact-object lint is enough to unblock switching on exact_by_default (for us and for other projects that want to do that too). 2. I guess we could go through and decide what should stay inexact and what should be made exact. But then each of those choices would have to be approved, and some of them would probably be breaking changes that we'd need to write changelog entries for. (Not ones that would affect an app at runtime -- but still, apps that use Flow would predictably have to change their code to adapt.) [1] https://medium.com/flow-type/how-to-upgrade-to-exact-by-default-object-type-syntax-7aa44b4d08ab
Just while we wait for the code in this package to be error-free when exact_by_default is enabled [1]. We plan to enable it for the RN v0.64 upgrade (zulip#4426). The PR is react-native-cameraroll/react-native-cameraroll#328. It's very possible that some of those object types would be better as exact instead of inexact. But: 1. Just getting the library to pass the implicit-inexact-object lint is enough to unblock switching on exact_by_default (for us and for other projects that want to do that too). 2. I guess we could go through and decide what should stay inexact and what should be made exact. But then each of those choices would have to be approved, and some of them would probably be breaking changes that we'd need to write changelog entries for. (Not ones that would affect an app at runtime -- but still, apps that use Flow would predictably have to change their code to adapt.) So instead, the PR just makes all the implicit inexact object types explicitly inexact. It's based directly on v4.0.4, the version we've been using, so it doesn't pull in any other changes. [1] https://medium.com/flow-type/how-to-upgrade-to-exact-by-default-object-type-syntax-7aa44b4d08ab
Added more detail to
docs/developer-guide.md
, based on my experience with installing the app on an iOS device for the first time. Not sure if we should make it more explicit.Improved current docs readability - shorter line lengths (mostly for
cat
ting / reading GH on a mobile device), more whitespace.