Skip to content
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

Merged
merged 2 commits into from
Feb 13, 2017

Conversation

trueskawka
Copy link
Member

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 catting / reading GH on a mobile device), more whitespace.

Add more detail to the developer guide for new contributors.
Add more whitespace to make README.md more readable.

## 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
Copy link
Member

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?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I get this when I don't change the string, on the latest master:
signing bundle

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.
Copy link
Member

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?

Copy link
Member Author

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 :)

chrisbobbe added a commit to chrisbobbe/zulip-mobile that referenced this pull request Sep 1, 2021
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
gnprice pushed a commit to chrisbobbe/zulip-mobile that referenced this pull request Sep 1, 2021
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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants