Merge branch 'your_first_project'

manuals/getting_started/your_first_project.rst

@@ -1,66 +1,200 @@
 Your first project
 ==================
 
-Create a new project
---------------------
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi mattis
-lectus sed mi malesuada efficitur ut faucibus turpis. Nulla urna orci,
-vulputate sit amet eleifend sed, vestibulum eget mauris. Mauris
-tincidunt, purus eget fringilla blandit, elit lorem tempor purus, nec
-finibus odio lacus in arcu. Sed sodales arcu ut ante fringilla
-tristique. Maecenas dictum velit nec quam efficitur pretium. Donec ex
-metus, consectetur vel elementum eu, congue ac felis. Maecenas ac purus
-rutrum lectus iaculis hendrerit quis ac augue. Pellentesque vehicula leo
-eget elit vulputate tempor. Aenean nec elit quis felis tristique
-volutpat. Pellentesque ut faucibus sem. Pellentesque habitant morbi
-tristique senectus et netus et malesuada fames ac turpis egestas. Nunc
-sollicitudin mauris posuere augue aliquet, sed efficitur erat cursus.
+The following is a tutorial on how to create a small audio track
+on audiotool.com and publish it on your profile from start-to-finish.
+
+You'll learn how to:  
+ * add synthesizers and other instruments to your project
+ * add a melody to your project
+ * browse and add samples to the project
+ * arrange the instruments and samples in a project
+ * export and publish the project to your profile, allowing others to remix it
+
+Getting started
+^^^^^^^^^^^^^^^
+
+Creating a new project
+----------------------
+
+Audiotool.com itself is the place to share your tracks, listen to other's tracks,
+and interact with other audiotool.com users.
+
+To create your own track, you first have to open the studio in the top bar:
+
+
+|/images/audiotool_com_top_bar.png|
+
+The studio splash screen will open, where you can choose to open recent projects, demo projects,
+or browser your whole library of projects. We're gonna start a new project from scratch, so click this button:
+
+|/images/audiotool_splash_screen.png|
+
+
+This will create a new project and save it to your browser's temporary storage. 
+It's good practice to store the project to your profile so you can open it from
+any browser anywhere.
+
+Press `File` -> `Save`
+
+|/images/save_project_dialogue.png|
+
+This will open the following dialogue:
+
+|/images/save_project_popup.png|
+
+Give your project a name and press save. Don't worry about the other options,
+they will only become relevant once you publish the track.
+
+From now on, all your changes wil automatically be stored in the cloud.
+
+Studio Overview
+---------------
+
+The studio is made up of a few sections. The area here is the *desktop*. This is where you can see and connect the devices you want to use. It is
+Also where you can turn the knobs and edit the parameters of the devices you are using. It's modeled after real life!
+
+|/images/desktop.png|
+
+The top section is the *main controls* for the song. You can play, stop, and record here. You can also set the *beats per minute* (bpm), *time signature*, 
+and *shuffle* amount. To edit them, double click, and type the desired value.
+
+|/images/main-controls.png|
+
+The *panel* is where you can drag devices from to the desktop. There is a large selection of drum instruments, synthesizers, effects, and other plugins.
+
+|/images/panel.png|
+
+The *timeline* is where you will arrange your song. It is a visual representation of your song over time. 
+
+|/images/timeline.png|
+
+The timeline is separated by rows called *tracks*. Each track represents a specific audiofile, automation, or MIDI sequence. In otherwords, the timeline 
+help to organize all the sounds in the song, and control when they come in.
+
+A more fleshed out project might look something like this:
+
+|/images/simple-completed-project.png|
+
+Creating sounds
+^^^^^^^^^^^^^^^
 
 Add a sample
 ------------
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi mattis
-lectus sed mi malesuada efficitur ut faucibus turpis. Nulla urna orci,
-vulputate sit amet eleifend sed, vestibulum eget mauris. Mauris
-tincidunt, purus eget fringilla blandit, elit lorem tempor purus, nec
-finibus odio lacus in arcu. Sed sodales arcu ut ante fringilla
-tristique. Maecenas dictum velit nec quam efficitur pretium. Donec ex
-metus, consectetur vel elementum eu, congue ac felis. Maecenas ac purus
-rutrum lectus iaculis hendrerit quis ac augue. Pellentesque vehicula leo
-eget elit vulputate tempor. Aenean nec elit quis felis tristique
-volutpat. Pellentesque ut faucibus sem. Pellentesque habitant morbi
-tristique senectus et netus et malesuada fames ac turpis egestas. Nunc
-sollicitudin mauris posuere augue aliquet, sed efficitur erat cursus.
+Audiotool has an extensive sample library database that contains both safe samples, and user uploaded samples. 
+Samples are small audio files that you can add to your track. To find the sample library, click on the "sample" button in the panel on the right. 
+
+|/images/sample-in-panel.png|
+
+Here, you can search for a desired sample. To preview samples, click on sample's text. You can click it again to stop playing.
+
+|/images/sample-search.gif|
+
+Once you find the desired sample, drag it out onto the desktop to add it to your project. An audiotrack device will appear on the desktop
+and a new audiotrack will be created on the timeline. 
+
+|/images/drag-sample-to-desktop.gif|
+
+Now you have the sample in the track! The sample will automatically be placed on the beginning of the track.
 
 An an instrument
 ----------------
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi mattis
-lectus sed mi malesuada efficitur ut faucibus turpis. Nulla urna orci,
-vulputate sit amet eleifend sed, vestibulum eget mauris. Mauris
-tincidunt, purus eget fringilla blandit, elit lorem tempor purus, nec
-finibus odio lacus in arcu. Sed sodales arcu ut ante fringilla
-tristique. Maecenas dictum velit nec quam efficitur pretium. Donec ex
-metus, consectetur vel elementum eu, congue ac felis. Maecenas ac purus
-rutrum lectus iaculis hendrerit quis ac augue. Pellentesque vehicula leo
-eget elit vulputate tempor. Aenean nec elit quis felis tristique
-volutpat. Pellentesque ut faucibus sem. Pellentesque habitant morbi
-tristique senectus et netus et malesuada fames ac turpis egestas. Nunc
-sollicitudin mauris posuere augue aliquet, sed efficitur erat cursus.
+If you want to create your own sounds without soly relying on samples, you can use audiotool's selection of instruments.
+The drum instruments are for percussive sounds, and the synthesizer instruments are for melodic sounds. Let's drag out a synthesizer called
+the "Pulverisateur". With so many knobs and buttons, it might seem intimidating, but it doesn't take much to make some really cool sounds out of this.
+
+|/images/drag-pulv-to-desktop.gif|
+
+Notice that in the timeline, a row called "Pulverisateur" has appered. This is a *note track*. Double click on the *note track* to make a rectangle area 
+in the timeline called a *note region*. 
+Double click on the *note region* to reveal a piano roll. 
+
+This is where you can create melodies. Double click in this timeline space to create notes. You can also drag the notes to move them around. To change
+the length of the notes, drag the right edge of the note.
+
+|/images/placing-editing-notes.gif|
+
+Now you can create your own melody! You can do this for mulitple synthesizers and note tracks. 
+
+Arrange timeline
+----------------
+
+Now that you have a few sounds, you can arrange them to come in at specific times. To do this, click on the regions and drag it to the desired time.
+You can also drag the right edge of the region to extend it. This will loop the region automatically according to the loop markers within the region.
+
+|/images/arranging-in-timeline.gif|
 
 Publish your work
--------------------
-
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi mattis
-lectus sed mi malesuada efficitur ut faucibus turpis. Nulla urna orci,
-vulputate sit amet eleifend sed, vestibulum eget mauris. Mauris
-tincidunt, purus eget fringilla blandit, elit lorem tempor purus, nec
-finibus odio lacus in arcu. Sed sodales arcu ut ante fringilla
-tristique. Maecenas dictum velit nec quam efficitur pretium. Donec ex
-metus, consectetur vel elementum eu, congue ac felis. Maecenas ac purus
-rutrum lectus iaculis hendrerit quis ac augue. Pellentesque vehicula leo
-eget elit vulputate tempor. Aenean nec elit quis felis tristique
-volutpat. Pellentesque ut faucibus sem. Pellentesque habitant morbi
-tristique senectus et netus et malesuada fames ac turpis egestas. Nunc
-sollicitudin mauris posuere augue aliquet, sed efficitur erat cursus.
+^^^^^^^^^^^^^^^^^
+
+Great work on the song! When you feel your song is finished and ready for the world to see, you can publish your track to audiotool.com.
+To do this, Press `File` -> `Publish`
+
+|/images/save-context.png|
+
+This will take you to a publish dialogue where you can name your song, add cover art, and write a description. Make sure to add tags and a genre, to 
+make your music easier to find. 
+
+|/images/publish-dialog.png|
+
+When you have finished filling out the track information, click the "publish" on the bottom. Once it finishes loading, you can find your track on your
+profile at audiotool.com. 
+
+Congratulations!
+
+
+.. |/images/audiotool_com_top_bar.png| image:: /images/audiotool_com_top_bar.png
+    :alt: The top bar of audiotool with an arrow showing where the studio button is.
+
+.. |/images/audiotool_splash_screen.png| image:: /images/audiotool_splash_screen.png
+    :alt: Splash screen of studio.audiotool.com
+
+.. |/images/save_project_dialogue.png| image:: /images/save_project_dialogue.png
+    :alt: Dialogue highlighting how to save a project
+
+.. |/images/save_project_popup.png| image:: /images/save_project_popup.png
+    :alt: Popup window showing how to save a file.
+
+.. |/images/sample-in-panel.png| image:: /images/sample-in-panel.png
+    :alt: Arrow highlighting where the sample tab is in the panel
+
+.. |/images/sample-search.gif| image:: /images/sample-search.gif
+    :width: 200
+    :alt: Gif of searching "jazz" in the sample search bar.
+
+.. |/images/drag-sample-to-desktop.gif| image:: /images/drag-sample-to-desktop.gif
+    :alt: Gif of dragging a sample to the desktop.
+
+.. |/images/drag-pulv-to-desktop.gif| image:: /images/drag-pulv-to-desktop.gif
+    :alt: Gif of dragging a Pulverisateur to the desktop.
+
+.. |/images/placing-editing-notes.gif| image:: /images/placing-editing-notes.gif
+    :alt: Gif notes being placed and moved.
+
+.. |/images/desktop.png| image:: /images/desktop.png
+    :alt: Highlighting the desktop portion in the app.
+
+.. |/images/panel.png| image:: /images/panel.png
+    :alt: Highlighting the panel portion in the app.
+
+.. |/images/timeline.png| image:: /images/timeline.png
+    :alt: Highlighting the timeline portion in the app.
+
+.. |/images/main-controls.png| image:: /images/main-controls.png
+    :alt: Highlighting the main controls in the app.
+
+.. |/images/simple-completed-project.png| image:: /images/simple-completed-project.png
+    :alt: Simple completed project.
+
+.. |/images/arranging-in-timeline.gif| image:: /images/arranging-in-timeline.gif
+    :alt: Gif of arranging and extending regions in the timeline.
+
+.. |/images/save-context.png| image:: /images/save-context.png
+    :width: 200
+    :alt: Save item in the main menu.
+
+.. |/images/publish-dialog.png| image:: /images/publish-dialog.png
+    :width: 400
+    :alt: Publish dialog screen.