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 ourterms of serviceand privacy statement.We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs] Update Safe areas guide for default template #30328

Merged
merged 4 commits into from
Jul 14, 2024

Conversation

amandeepmittal
Copy link
Member

@amandeepmittal amandeepmittal commented Jul 10, 2024

Why

Part of on-going improvements for docs under Develop section.

How

This PR updates the Safe Areas guide to include

  • Explain concisely about using safe areas
  • Update installation section to mention different Expo template behavior and provide installation instructions accordingly
  • Update Usage section to add steps
  • UpdateuseSafeAreaInsetshook section to include a code example
  • Add Additional information section to group minimal example, React Navigation usage info, and web usage info
  • Fix link in the web usage section to point towards the correct usage info for `SafeAreaProvider
  • Improve overall verbiage of the doc.

Test Plan

By running docs locally and visiting:http://localhost:3002/develop/user-interface/safe-areasor see Preview:http://docs.expo.dev-pr-30328.s3-website-us-east-1.amazonaws /develop/user-interface/safe-areas/.

Checklist

@expo-bot expo-bot added the bot: passed checks ExpoBot has nothing to complain about label Jul 10, 2024
@expo-bot
Copy link
Collaborator

expo-bot commented Jul 10, 2024

📘 Your docspreview websiteis ready!

Copy link
Collaborator

@Simek Simek left a comment

Choose a reason for hiding this comment

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

LGTM! 👍

@amandeepmittal
Copy link
Member Author

I've updated the doc to clarify some confusing/vague parts. Also, used Create a project doc link to link the default template context. It wasn't clear by going to the default template GitHub link as to where this library is coming from. Last update made to this guide was about removing the collapsible to add installation instructions as an alternate directly under the installation section.

@amandeepmittal amandeepmittal merged commitdd1bcfd into main Jul 14, 2024
2 checks passed
@amandeepmittal amandeepmittal deleted the aman/update-safe-areas branch July 14, 2024 18:09
alanjhughes pushed a commit that referenced this pull request Jul 17, 2024
# Why

<!--
Please describe the motivation for this PR, and link to relevant GitHub
issues, forums posts, or feature requests.
-->

Part of on-going improvements for docs under Develop section.

# How

<!--
How did you build this feature or fix this bug and why?
-->

This PR updates the Safe Areas guide to include
- Explain concisely about using safe areas
- Update installation section to mention different Expo template
behavior and provide installation instructions accordingly
- Update Usage section to add steps
- Update `useSafeAreaInsets` hook section to include a code example
- Add Additional information section to group minimal example, React
Navigation usage info, and web usage info
- Fix link in the web usage section to point towards the correct usage
info for `SafeAreaProvider
- Improve overall verbiage of the doc.

# Test Plan

<!--
Please describe how you tested this change and how a reviewer could
reproduce your test, especially if this PR does not include automated
tests! If possible, please also provide terminal output and/or
screenshots demonstrating your test/reproduction.
-->

By running docs locally and visiting:
http://localhost:3002/develop/user-interface/safe-areas or see Preview:
http://docs.expo.dev-pr-30328.s3-website-us-east-1.amazonaws /develop/user-interface/safe-areas/.

# Checklist

<!--
Please check the appropriate items below if they apply to your diff.
This is required for changes to Expo modules.
-->

- [x] Documentation is up to date to reflect these changes (eg:
https://docs.expo.devand README.md).
- [x] Conforms with the [Documentation Writing Style
Guide](https://github /expo/expo/blob/main/guides/Expo%20Documentation%20Writing%20Style%20Guide.md)
- [ ] This diff will work correctly for `npx expo prebuild` & EAS Build
(eg: updated a module plugin).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bot: passed checks ExpoBot has nothing to complain about preview
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants