Update READMEs: clean up, remove redundant parts, update commands.

Author: greenrobot-team

Example/README.md

@@ -5,16 +5,10 @@ The example comes with two apps: one for iOS and one for macOS. The iOS example
 
 Example setup
 -------------
-Just like in any other project, you need te setup CocoaPods and ObjectBox.
-Simply run `./setup.sh` inside this directory, or copy paste this into a terminal:
+Just like in any other project, you need to set up CocoaPods and ObjectBox.
+Simply run `./setup.sh` inside this directory, or run these commands in a terminal:
 
-    pod install # if that fails, update CocoaPods (see Installation)
+    pod install --repo-update # if that fails, update CocoaPods (see Installation)
     Pods/ObjectBox/setup.rb
 
 This will generate a `NotesExample.xcworkspace` that you can launch to try out ObjectBox.
-
-Updating to newer ObjectBox versions
-------------------------------------
-    pod repo update
-    pod update
-    Pods/ObjectBox/setup.rb

README.md

@@ -45,20 +45,6 @@ let oldClauses = query.find()
 Want details? **[Read the guides](https://swift.objectbox.io/)** or
 **[check out the API docs](https://objectbox.io/docfiles/swift/current/)**.
 
-## Table of Contents
-- [Why use ObjectBox for Swift data persistence?](#why-use-objectbox-for-swift-data-persistence)
-    - [Features](#features)
-- [Adding ObjectBox to your project](#adding-objectbox-to-your-project)
-    - [New to CocoaPods?](#new-to-cocoapods)
-    - [CocoaPods troubleshooting](#cocoapods-troubleshooting)
-    - [Swift Versions](#swift-versions)
-- [Example](#example)
-- [Background: code generation](#background-code-generation)
-- [Source code](#source-code)
-- [Already using ObjectBox?](#already-using-objectbox)
-- [Cross-platform database: Mobile, Desktop, Browser, Embedded, IoT](#cross-platform-database-mobile-desktop-browser-embedded-iot)
-- [License](#license)
-
 ## Why use ObjectBox for Swift data persistence?
 
 Simple but powerful; frugal but fast: The ObjectBox NoSQL database offers an intuitive Swift API that's easy to pick up, fun to work with, and incredibly fast, making it sustainable in many ways. Its frugal recource use (CPU, memory, battery / power) makes ObjectBox an ideal and sustainable choice for iOS apps. So why not give it a try right away? Check out the [installation section below](#adding-objectbox-to-your-project). You can also star this repository for later 🌟
@@ -83,50 +69,50 @@ On top, ObjectBox comes with an [out-of-the-box Data Sync](https://objectbox.io/
 
 <a name="cocoapods"></a>Adding ObjectBox to your project
 --------------------------------------------------------
-[CocoaPods](https://cocoapods.org) is recommended to set up ObjectBox in your project.
-See the [installation docs](https://swift.objectbox.io/install) for alternative setups,
-or the [New to CocoaPods?](#new-to-cocoapods) section below for a quick intro.
-To install the `ObjectBox` pod, add the following line to your Podfile:
+ObjectBox is available as a [CocoaPods](https://cocoapods.org) pod. [See the docs](https://swift.objectbox.io/install) for details and alternative setup options.
+
+If you are new to CocoaPods, [check out their website](https://cocoapods.org) for an introduction and installation instructions.
+
+To add the ObjectBox Swift dependency, add the following line to your `Podfile`:
 
 ```ruby
   pod 'ObjectBox'
 ```
 
-Then run this to install the ObjectBox framework:
+Then run these commands in your project directory to install the ObjectBox framework:
 
 ```bash
-cd /path/to/your/project/folder/ # whatever folder your Podfile is in.
-pod install
-Pods/ObjectBox/setup.rb myproject.xcodeproj # whatever your Xcode project is named
+pod install --repo-update
+Pods/ObjectBox/setup.rb
 ```
 
-And, don't forget to close the Xcode project (.xcodeproj) and open the workspace (.xcworkspace) instead.
-Now, you are all set to define your first ObjectBox entities;
-e.g. check the [getting started guide](https://swift.objectbox.io/getting-started) or the [example](#example) described below. 
+Then open your Xcode workspace (.xcworkspace) instead of the Xcode project (.xcodeproj).
 
-### <a name="new-to-cocoapods"></a>New to CocoaPods?
+Now, you are all set to define your first ObjectBox entities;
+e.g. check the [getting started guide](https://swift.objectbox.io/getting-started) or the [example](#example) described below.
 
-[CocoaPods](https://cocoapods.org) is a dependency manager and sets up libraries like ObjectBox in your Xcode project.
-To install it, run this in a terminal: 
+### CocoaPods troubleshooting
 
-```bash
-sudo gem install cocoapods
-```
+If `pod install` fails, try updating CocoaPods first:
 
-In CocoaPods, you keep track of used libraries in a file called "Podfile".
-If you don't have this file yet, navigate to your Xcode project folder and use CocoaPods to create one:
+    gem update xcodeproj && gem update cocoapods && pod repo update
 
-```bash
-pod init
-```
+## Updating to newer ObjectBox versions
 
-### CocoaPods troubleshooting
+Update the ObjectBox pod and re-run the setup script:
 
-If `pod install` fails, try updating CocoaPods first:
+```shell
+pod repo update
+pod update ObjectBox
+Pods/ObjectBox/setup.rb
+```
 
-    gem update xcodeproj && gem update cocoapods && pod repo update
+<a name="example"></a>Example
+-----------------------------
+In the [Example](Example/) directory, you'll find a "Notes" example app demonstrating ObjectBox's Swift API.
+The example comes with two apps: one for iOS and one for macOS. The iOS example is a full GUI application, whereas the macOS example runs a few operations and then exits.
 
-### Swift versions
+## Swift versions
 
 Here's a list of ObjectBox releases, and the Swift versions they were compiled with:
 
@@ -144,29 +130,16 @@ Here's a list of ObjectBox releases, and the Swift versions they were compiled w
 
 This might be relevant, e.g. when using Carthage. For various reasons, we recommend using the latest version.
 
-<a name="example"></a>Example
------------------------------
-In the [Example](Example/) directory, you'll find a "Notes" example app demonstrating ObjectBox's Swift API.
-The example comes with two apps: one for iOS and one for macOS. The iOS example is a full GUI application, whereas the macOS example runs a few operations and then exits.
-
-To setup the example, use CocoaPods to acquire the framework:
-
-    cd Example/
-    pod install # if that fails, update CocoaPods (see Installation)
-    Pods/ObjectBox/setup.rb
-
-This will generate a `NotesExample.xcworkspace` that you can launch to try out ObjectBox.
+Development
+-----------
+The source code for ObjectBox's Swift binding can be found [in the Source folder](Source/README.md) of this repository.
 
 Background: code generation
 ---------------------------
 ObjectBox Swift Database generates code at build time for optimal performance at runtime by avoiding reflection etc.
 This is automatically done for you and should be transparent.
 Internally, we use [a fork of Sourcery](https://github.com/objectbox/objectbox-swift-generator) for this.
 
-Source code
------------
-Source code for ObjectBox's Swift binding can be found [in the Source folder](Source/README.md).
-
 Already using ObjectBox?
 ---------------------------
 
@@ -197,9 +170,8 @@ ObjectBox is a cross-platform database supporting sustainable app development in
 
 License
 -------
-All files in this repository are under the Apache 2 license:
 
-    Copyright 2018-2022 ObjectBox Ltd. All rights reserved.
+    Copyright 2018-2023 ObjectBox Ltd. All rights reserved.
 
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
@@ -213,3 +185,5 @@ All files in this repository are under the Apache 2 license:
     See the License for the specific language governing permissions and
     limitations under the License.
 
+Note that this license applies to the code in this repository only.
+See our website on details about all [licenses for ObjectBox components](https://objectbox.io/faq/#license-pricing).