docs: update README.md

Author: codybrom

.github/ISSUE_TEMPLATE/bug_report.md

@@ -23,7 +23,7 @@ A clear and concise description of what you expected to happen.
 
 **System Information:**
 
-- macOS Version: [e.g. 14.5, 15.2]
+- macOS Version: [e.g. 14.6, 15.2]
 - Blankie Version: [e.g. 1.0.1 (256)]
 - Installation Source: [TestFlight Beta / GitHub Release / Mac App Store]
 

CONTRIBUTING.md

@@ -95,8 +95,8 @@ When we have a foundation set for translations, we will be looking for contribut
 At this time, we're not seeking new sound contributions to Blankie. However, if you have suggestions for sound effects, you are welcomed to post in the [_"What Sounds Would You Add to Blankie?"_ discussion thread](https://github.com/codybrom/blankie/discussions/13).
 
 ## Other Contributions
-There are undoubtedly other ways to contribute to Blankie that aren't covered above. If you have an idea for a new way to contribute, please open an issue to discuss it!
 
+There are undoubtedly other ways to contribute to Blankie that aren't covered above. If you have an idea for a new way to contribute, please open an issue to discuss it!
 
 ## Licensing
 

README.md

@@ -2,7 +2,7 @@
 
 ### Blankie
 
-<small>Ambient sound mixer inspired by <a href="https://github.com/rafaelmardojai/blanket">Blanket</a></small>
+<small>Ambient sound mixer for macOS inspired by <a href="https://github.com/rafaelmardojai/blanket">Blanket</a></small>
 
 [![macOS](https://img.shields.io/badge/14.6+-111111?logo=macOS&logoColor=white&logoSize=auto&logoWidth=25)](https://www.apple.com/macos/)
 [![Swift](https://img.shields.io/badge/Swift%205-F05138?logo=Swift&logoColor=white)](https://swift.org)
@@ -24,54 +24,113 @@ Blankie makes it easy to mix different ambient sounds into a custom soundscape.
 - Individual volume controls for each sound
 - Global volume control
 - Preset system to save your favorite sound combinations
-- Native macOS integration
+- Native macOS integration:
   - System media controls
   - Automatic or customizable light/dark modes
   - Automatic or custom accent colors
 
-## Requirements to Run
+## Contributing
+
+We welcome contributions from the community! There are many ways to contribute to Blankie:
+
+- **Code**: Help fix bugs, add features, or improve performance
+- **Testing**: Try new features and report issues
+- **Documentation**: Improve our docs and website
+- **Ideas**: Submit feature requests and provide feedback
+
+Before contributing, please review our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).
 
-macOS Sonoma 14.6 or later
+### Current Priority Areas for Contribution
+
+We're currenly looking for help with:
+
+- [Adding custom sound support](https://github.com/codybrom/blankie/issues/1)
+- [Internationalization / Translation](https://github.com/codybrom/blankie/issues/2)
 
 ## Development Setup
 
-1. Clone the repository
-2. Copy `Configuration.example.xcconfig` to `Configuration.xcconfig`
-3. Edit `Configuration.xcconfig` to set your development team and bundle identifier:
+1. **Fork the repository and clone it to your local machine.**
+
+2. **Copy `Configuration.example.xcconfig` to `Configuration.xcconfig`.**
+    - Configuration.xcconfig is ignored by git to keep Bundle IDs and Team IDs private. Do not commit this file publicly to protect your work from impersonation, account misuse, and distribution conflicts.
+
+3. **Add your development team to `Configuration.xcconfig`.**
+
+      ```plaintext
+      DEVELOPMENT_TEAM = YOUR_TEAM_ID_HERE
+      ```
+
+    - **Apple Developer Program Members:**
+        - Retrieve your **Team ID**:
+            1. Open Xcode and go to **Xcode > Preferences > Accounts**.
+            2. Sign in with your Apple ID if you haven’t already.
+            3. Select your account, click **Manage Certificates** or **View Details**, and find your **Team ID** under your account name.
+        - Add your Team ID to `Configuration.xcconfig`:
+
+    - **If You Are Not a Member of the Apple Developer Program:**
+        - You can still test the app on your devices for free by creating an Xcode **Personal Team**. Follow these steps:
+            1. Open Xcode and go to **Xcode > Preferences > Accounts**.
+            2. Click the "+" button to add your Apple ID (if not already added).
+            3. After signing in, Xcode will automatically create a **Personal Team** associated with your Apple ID.
+            4. Go to **Xcode > Preferences > Accounts**, select your account, and click **View Details**. The Team ID for your Personal Team will be listed.
+        - Use the Team ID from your Personal Team in `Configuration.xcconfig`:
+
+4. **Set the Bundle Identifier:**
 
-   ```xcconfig
-   DEVELOPMENT_TEAM = YOUR_TEAM_ID_HERE
-   PRODUCT_BUNDLE_IDENTIFIER = com.your.identifier
-   ```
+      ```plaintext
+      PRODUCT_BUNDLE_IDENTIFIER = com.yournamehere.blankie
+      ```
 
-4. Open `Blankie.xcodeproj` in Xcode
-5. Build and run!
+    - In `Configuration.xcconfig`, set `PRODUCT_BUNDLE_IDENTIFIER` to a unique identifier. You can use any reverse domain name format for the bundle identifier, but it must be unique. You **cannot** use the same bundle identifier as the main Blankie app.
 
-Note: `Configuration.xcconfig` is ignored by git to keep your personal development settings private.
+5. **Open `Blankie.xcodeproj` in Xcode**
 
-## Sound Credits
+6. **Build and run the project!**
 
-All sounds are used under various open licenses. Full attribution information about sounds licensing available at [Blankie.rest/credits](https://blankie.rest/credits) or on the About screen of the app.
+## Documentation
+
+Additional information about Blankie, including an FAQ and more credits, are available on the [Blankie website](https://blankie.rest). The website is created using Astro and hosted on GitHub Pages. The source code is available in the `docs` directory.
+
+Information about the Blankie website's source code can be found in its [README](docs/README.md) file.
 
 ## Credits
 
+### Special Thanks
+
 An incredibly special thanks to [Rafael Mardojai CM](https://github.com/rafaelmardojai) and all the contributors to the [Blanket](https://github.com/rafaelmardojai/blanket) project which inspired me to build this app when I couldn't find a free, simple and open-source Mac app like it.
 
-## Contributing
+### Sounds
 
-Contributions are welcome! Please feel free to submit a Pull Request. Here are some areas that still need work to bring it to parity with Blanket:
+The sounds in Blankie are used under various open licenses. Full attribution information about sounds and licensing is available on the Blankie website at [blankie.rest/credits](https://blankie.rest/credits) or on the About screen of the app.
 
-- [Add custom sound support](https://github.com/codybrom/blankie/issues/1)
-- [Internationalization / Translation](https://github.com/codybrom/blankie/issues/2)
+### App Logo / Icon
+
+The Blankie logo and app icon were created by [Cody Bromley](https://github.com/codybrom) and are licensed under a <a href="https://creativecommons.org/licenses/by/4.0/?ref=chooser-v1" target="_blank" rel="license noopener noreferrer">Creative Commons Attribution 4.0 International license <img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/cc.svg?ref=chooser-v1" alt=""><img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/by.svg?ref=chooser-v1" alt=""></a>
+
+You may share, copy, and adapt the Blankie logo/icon, but you must give appropriate credit, link to the license, and indicate if changes were made.
+
+Press and media may use the Blankie app icon and logo without modification to reference the Blankie app, provided proper attribution is given.
+
+### Sound Icons
+
+Blankie uses [SF Symbols](https://developer.apple.com/sf-symbols/) for sound icons. SF Symbols are provided by Apple as a system resource, with usage governed by the [Xcode and Apple SDKs Agreement](https://www.apple.com/legal/sla/docs/xcode.pdf). They are not stored in this repository and are not covered by Blankie's license.
+
+## License & Copyright
+
+© 2024 Cody Bromley. All rights reserved.
+
+The Blankie name and trademark rights are reserved. The Blankie logo and app icon are licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).
 
-## License
+The Blankie source code and website code are copyright Cody Bromley and licensed under the MIT License. Please read Blankie's [LICENSE](LICENSE) for full details. Contributions to Blankie are welcome and will be released under the same license.
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+Different components of Blankie (such as sounds, icons, or others) may be covered by different licenses. Full attribution information about sounds and licensing for included items is available on the Blankie website at [blankie.rest/credits](https://blankie.rest/credits) and on the About screen of the app.
 
-## Support
+## Support & Community
 
-If you encounter any issues or have feature requests, please file them in the [GitHub Issues](https://github.com/codybrom/blankie/issues) section.
+- 🐛 Find a bug? [Open an issue](https://github.com/codybrom/blankie/issues/new?assignees=&labels=bug&projects=&template=bug_report.md&title=BUG%3A+)
+- 💡 Have an idea? [Submit a feature request](https://github.com/codybrom/blankie/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=IDEA%3A+)
+- 💬 Join the discussion in our [GitHub Discussions](https://github.com/codybrom/blankie/discussions)
 
 ---
 
-Note: Blankie is an independent project built for macOS. Blankie and its developer did not use any of the original code from the Blanket project. Blankie is not affiliated with or endorsed by the Blanket project.
+> Blankie is an independent macOS application inspired by Blanket. Blankie was built without re-using any code from the Blanket project, though it does use some of the same openly licensed sound files. Blankie is not affiliated with or endorsed by the Blanket team or any of its contributors.