[Docs] Language improvements (#259)

* fix: language in getting started and make some noise

* fix: language in docs

Co-authored-by: Katarzyna Smoleń <katarzyna.smolen@swmansion.com>

---------

Co-authored-by: Katarzyna Smoleń <katarzyna.smolen@swmansion.com>

Author: michalsek

packages/audiodocs/docs/fundamentals/getting-started.mdx

@@ -8,20 +8,20 @@ import TabItem from '@theme/TabItem';
 
 # Getting started
 
-The goal of _Fundamentals_ is to guide You through setup proces of Audio API as well as show base concepts standing behind audio programming using web audio framework to give you the confidence to explore more advanced use cases on your own. This section is packed with interactive examples, code snippets and explanations. Are you ready? Let's make some noise!
+The goal of _Fundamentals_ is to guide you through the setup process of the Audio API, as well as to show the basic concepts behind audio programming using a web audio framework, giving you the confidence to explore more advanced use cases on your own. This section is packed with interactive examples, code snippets, and explanations. Are you ready? Let's make some noise!
 
 ## What is React Native Audio API?
 
-React Native Audio API is a powerful high-performant and low-level audio library built by [Software Mansion](https://swmansion.com/).
+React Native Audio API is a powerful, high-performant and low-level audio library built by [Software Mansion](https://swmansion.com/).
 RN Audio API is fully compatible\* with [Web Audio specification](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API), making it easy to write audio-intensive applications for iOS, Android and Web with just one codebase.
 
 ## Installation
 
-It takes only a few steps to add audio api to Your project:
+It takes only a few steps to add Audio API to your project:
 
 ### Install the package
 
-Install `react-native-audio-api` package from npm:
+Install the `react-native-audio-api` package from npm:
 
 <Tabs groupId="package-managers">
   <TabItem value="expo" label="EXPO" default>
@@ -62,7 +62,7 @@ To learn more about expo development builds, please check out [Development Build
 
 #### Android
 
-No additional steps are necessary.
+No further steps are necessary.
 
 #### iOS
 
@@ -74,11 +74,11 @@ cd ios && pod install && cd ..
 
 #### Web
 
-No additional steps are necessary.
+No further steps are necessary.
 
 :::caution
 
-`react-native-audio-api` on web, exposes browser built-in Web Audio API, but for compatibility between platforms, its limits available interfaces to APIs that are implemented on iOS and Android.
+`react-native-audio-api` on the web exposes the browser's built-in Web Audio API, but for compatibility between platforms, it limits the available interfaces to APIs that are implemented on iOS and Android.
 
 :::
 
@@ -104,4 +104,4 @@ No additional steps are necessary.
 
 ## What's next?
 
-In [the next section](/fundamentals/lets-make-some-noise), we will learn how to prepare audio api and how to play some sound!.
+In [the next section](/guides/lets-make-some-noise), we will learn how to prepare Audio API and to play some sound!.

packages/audiodocs/docs/fundamentals/lets-make-some-noise.mdx renamed to packages/audiodocs/docs/guides/lets-make-some-noise.mdx

@@ -4,7 +4,7 @@ sidebar_position: 2
 
 # Let's make some noise!
 
-In this section, we will guide you through the basic concepts of Audio API. We're going to use core audio components such as `AudioContext` and `AudioBufferSourceNode` to simply play sound from a file, which will help you develop a basic understanding of the library.
+In this section, we will guide you through the basic concepts of Audio API. We are going to use core audio components such as `AudioContext` and `AudioBufferSourceNode` to simply play sound from a file, which will help you develop a basic understanding of the library.
 
 ## Using audio context
 
@@ -28,11 +28,11 @@ export default function App() {
 }
 ```
 
-`AudioContext` is object that controls both the creation of the nodes, as well as execution of the audio processing, or decoding.
+`AudioContext` is an object that controls both the creation of the nodes and the execution of the audio processing or decoding.
 
-## Loading audio file
+## Loading an audio file
 
-Before we will be able to play anything, we need to gain access to some audio data. For the purpose of this guide, we will first download it from remote source using expo [FileSystem](https://docs.expo.dev/versions/latest/sdk/filesystem/) `downloadAsync` API.
+Before we can play anything, we need to gain access to some audio data. For the purpose of this guide, we will first download it from a remote source using [Expo FileSystem](https://docs.expo.dev/versions/latest/sdk/filesystem/) `downloadAsync` API.
 
 ```jsx {2,10-13}
 import React from 'react';
@@ -58,11 +58,11 @@ export default function App() {
 }
 ```
 
-We have used `decodeAudioDataSource` method of the `AudioContext`, which takes url to local file or bundled audio asset and decodes it to raw audio data, that can be used within our system.
+We have used the `decodeAudioDataSource` method of the `AudioContext`, which takes a URL to a local file or bundled audio asset and decodes it into raw audio data that can be used within our system.
 
 ## Play the audio
 
-Last and final step is to create `AudioBufferSourceNode`, connect it to the `AudioContext` destination and start playing the sound. For the purpose of this guide, we will play the sound for only 10 seconds.
+The last and final step is to create an `AudioBufferSourceNode`, connect it to the `AudioContext` destination, and start playing the sound. For the purpose of this guide, we will play the sound for just 10 seconds.
 
 ```jsx {15-16,18-20}
 import React from 'react';
@@ -95,7 +95,7 @@ export default function App() {
 }
 ```
 
-And that's it! You have just played Your first sound using react-native-audio-api. You can hear how it works in the live example below:
+And that's it! you have just played your first sound using react-native-audio-api. you can hear how it works in the live example below:
 
 import InteractiveExample from '@site/src/components/InteractiveExample';
 import LetsMakeSomeNoise from '@site/src/examples/LetsMakeSomeNoise/Component';
@@ -105,7 +105,7 @@ import LetsMakeSomeNoiseSrc from '!!raw-loader!@site/src/examples/LetsMakeSomeNo
 
 :::info
 
-In web environment you can use `decodeAudioDataSource` directly on the asset url, without the need to download it first.
+In the web environment, you can use `decodeAudioDataSource` directly on the asset URL, without the need to download it first.
 
 :::
 
@@ -114,11 +114,11 @@ In web environment you can use `decodeAudioDataSource` directly on the asset url
 In this guide, we have learned how to create a simple audio player using `AudioContext` and `AudioBufferSourceNode` as well as how we can load audio data from a remote source. To sum up:
 
 - `AudioContext` is the main object that controls the audio graph.
-- `decodeAudioDataSource` method can be used to load audio data from a local audio source in form of `AudioBuffer`.
-- `AudioBufferSourceNode` can be used to any `AudioBuffer`.
+- the `decodeAudioDataSource` method can be used to load audio data from a local audio source in the form of an `AudioBuffer`.
+- `AudioBufferSourceNode` can be used with any `AudioBuffer`.
 - In order to hear the sounds, we need to connect the source node to the destination node exposed by `AudioContext`.
-- We can control the playback of the sound using `start` and `stop` methods of the `AudioBufferSourceNode` (And other source nodes which we show later).
+- We can control the playback of the sound using `start` and `stop` methods of the `AudioBufferSourceNode` (and other source nodes, which we will show later).
 
 ## What's next?
 
-In [the next section](/fundamentals/making-a-piano-keyboard) we will learn more about how the audio graph works, what are audio params and how we can use them to create a simple piano keyboard.
+In [the next section](/fundamentals/making-a-piano-keyboard), we will learn more about how the audio graph works, what audio parameters are, and how we can use them to create a simple piano keyboard.