From 2b80dd74fcc5a698629b14af79fee9e5501659b3 Mon Sep 17 00:00:00 2001
From: nicco1690 <78063037+nicco1690@users.noreply.github.com>
Date: Wed, 9 Feb 2022 22:40:51 -0500
Subject: [PATCH 1/2] Add sample documentation (WIP, needs images)

---
 papers/doc/6-sample/README.md | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/papers/doc/6-sample/README.md b/papers/doc/6-sample/README.md
index 394f12d77..ae4c237cd 100644
--- a/papers/doc/6-sample/README.md
+++ b/papers/doc/6-sample/README.md
@@ -1,3 +1,29 @@
-# sample editor
+# samples
 
-TODO
+In the context of Furnace, a sound sample (usually just referred to as a sample) is a string of numbers that hold sampled PCM audio.
+
+In Furnace, these samples can be generated by importing a .wav (think of it as an higher quality MP3) file.
+
+## supported systems
+
+As of Furnace 0.5.5, the following sound chips have sample support:
+ - NES/Ricoh 2A03 (PCM only, no DPCM, and only on channel 5)
+ - Sega Genesis/YM2612 (channel 6 only; but only if there exists a `1701` effect that gets played on or before a trigger for a sample)
+ - PC Engine/TurboGrafx 16/Huc6280 (same conditions as above)
+ - Amiga/Paula (on all channels AND resamplable, but you need to make an instrument with the Amiga format and tie it to a sample first)
+ - Arcade/SEGA PCM (same as above but you don't need to make an instrument for it and you have to use the `20xx` effect command to resample your samples)
+ - Neo Geo/Neo Geo EXT-Ch2 (on the last 5 channels only and can be resampled the same way as above)
+ - Theoretically, the GameBoy channel 3 and the main channels of the Huc6280 can play (low quality) samples if data is given to them fast enough.
+
+Furnace also has a feature where you can make an Amiga formarted instrument on the YM2612 and Huc6280 and resample your samples in conjunction with the `1701` effect command.
+
+# the sample editor
+
+You can actually tweak your samples in Furnace's sample editor, which can be accessed by clicking on `window` (at the top of the screen) then clicking on `sample editor`.
+
+In there, you can modify certain data pertaining to your sample, such as the:
+ - volume of the sample (from 0% of the original to 200% of the original)
+ - pitch of the sample (from 1/6 of the original sample pitch to 6x the original sample pitch)
+ - and the sample rate of the sample (from 1KHz (1,000Hz) to 32KHz (32,000Hz)).
+
+To apply the changes you made to a sample, just click the `apply` button at the bottom, near the preview button.

From 6a1d143fabd92485d50dae9e8a89c33a5f0c56e6 Mon Sep 17 00:00:00 2001
From: nicco1690 <78063037+nicco1690@users.noreply.github.com>
Date: Wed, 9 Feb 2022 22:57:02 -0500
Subject: [PATCH 2/2] Update sample docs to be more clear

Changed according to changes requested by tildearrow
---
 papers/doc/6-sample/README.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/papers/doc/6-sample/README.md b/papers/doc/6-sample/README.md
index ae4c237cd..30efbf747 100644
--- a/papers/doc/6-sample/README.md
+++ b/papers/doc/6-sample/README.md
@@ -13,9 +13,8 @@ As of Furnace 0.5.5, the following sound chips have sample support:
  - Amiga/Paula (on all channels AND resamplable, but you need to make an instrument with the Amiga format and tie it to a sample first)
  - Arcade/SEGA PCM (same as above but you don't need to make an instrument for it and you have to use the `20xx` effect command to resample your samples)
  - Neo Geo/Neo Geo EXT-Ch2 (on the last 5 channels only and can be resampled the same way as above)
- - Theoretically, the GameBoy channel 3 and the main channels of the Huc6280 can play (low quality) samples if data is given to them fast enough.
 
-Furnace also has a feature where you can make an Amiga formarted instrument on the YM2612 and Huc6280 and resample your samples in conjunction with the `1701` effect command.
+Furnace also has a feature where you can make an Amiga formarted instrument on the YM2612 and Huc6280 to resample a sample you have in the module.
 
 # the sample editor