Skip to content

Commit d4319b5

Browse files
authored
Update 06-organization.md
1 parent bf13768 commit d4319b5

File tree

1 file changed

+18
-15
lines changed

1 file changed

+18
-15
lines changed

_episodes/06-organization.md

+18-15
Original file line numberDiff line numberDiff line change
@@ -16,22 +16,24 @@ keypoints:
1616

1717
## Getting your project started
1818

19-
Project organization is one of the most important parts of a sequencing project, and yet is often overlooked amidst the
19+
Project organization is one of the most essential parts of a sequencing project, and yet, it is often overlooked amidst the
2020
excitement of getting a first look at new data. Of course, while it is best to get yourself organized before you even begin your analyses,
21-
it is never too late to start, either.
21+
it is never too late to start.
2222

23-
You should approach your sequencing project similarly to how you do a biological experiment and this ideally begins with experimental design. We're going to assume that you've already designed a beautiful
24-
sequencing experiment to address your biological question, collected appropriate samples, and that you have
23+
You should approach your sequencing project similarly to how you do a biological experiment,
24+
and this ideally begins with experimental design. We're going to assume that you've already designed a beautiful
25+
sequencing experiment to address your biological question, collected appropriate samples, and have
2526
enough statistical power to answer the questions you're interested in asking. These
26-
steps are all incredibly important, but beyond the scope of our course.
27+
steps are all crucial but beyond the scope of our course.
2728
For all of those steps (collecting specimens, extracting DNA, prepping your samples)
2829
you've likely kept a lab notebook that details how and why you did each step. However, the process of documentation doesn't stop at
2930
the sequencer!
3031

3132
Genomics projects can quickly accumulate hundreds of files across
32-
tens of folders. Every computational analysis you perform over the course of your project is going to create
33-
many files, which can especially become a problem when you'll inevitably want to run some of those
34-
analyses again. For instance, you might have made significant headway into your project, but then have to remember the PCR conditions
33+
tens of folders. Every computational analysis you perform throughout your project will create
34+
many files, which can especially become problematic when you inevitably want to rerun some of those
35+
analyses. For instance, you might have made significant headway
36+
into your project but must remember the PCR conditions
3537
you used to create your sequencing library months prior.
3638

3739
Other questions might arise along the way:
@@ -40,22 +42,23 @@ Other questions might arise along the way:
4042
- Which quality cutoff did you use?
4143
- What version of a given program did you implement your analysis in?
4244

43-
Good documentation is key to avoiding this issue, and luckily enough,
45+
Good documentation is vital in avoiding this issue, and luckily enough,
4446
recording your computational experiments is even easier than recording lab data. Copy/Paste will become
4547
your best friend, sensible file names will make your analysis understandable by you and your collaborators, and
46-
writing the methods section for your next paper will be easy! Remember that in any given project of yours, it's worthwhile to consider
47-
a future version of yourself as an entirely separate collaborator. The better your documenation is, the more this 'collaborator' will
48+
writing the methods section for your following paper will be easy! Remember that in any project of yours, it's worthwhile to consider
49+
a future version of yourself as an entirely separate collaborator. The better your documentation is, the more this 'collaborator' will
4850
feel indebted to you!
4951

50-
With this in mind, let's have a look at the best practices for
52+
With this in mind, let's look at the best practices for
5153
documenting your genomics project. Your future self will thank you.
5254

53-
In this exercise we will setup a file system for the project we will be working on during this workshop.
55+
In this exercise, we will set up a file system for the project we will be working on during this workshop.
5456

55-
We will start by creating a directory that we can use for the rest of the workshop. First navigate to your home directory. Then confirm that you are in the correct directory using the `pwd` command.
57+
We will start by creating a directory that we can use for the rest of the workshop.
58+
First, navigate to your home directory. Then, confirm that you are in the correct directory using the `pwd` command.
5659

5760
~~~
58-
$ cd
61+
$ cd ~
5962
$ pwd
6063
~~~
6164
{: .bash}

0 commit comments

Comments
 (0)