summaryrefslogtreecommitdiffstats
path: root/2024/captions
diff options
context:
space:
mode:
authorEmacsConf <emacsconf-org@gnu.org>2024-12-07 09:40:13 -0500
committerEmacsConf <emacsconf-org@gnu.org>2024-12-07 09:40:13 -0500
commit8071b3fa33a1e32fe1ee608b586c499d20d8dc11 (patch)
treef541614cf92d0074a5491c04c2078afcfdf96d65 /2024/captions
parent46a1448aebf6e6d18a424624a295fe724810980f (diff)
downloademacsconf-wiki-8071b3fa33a1e32fe1ee608b586c499d20d8dc11.tar.xz
emacsconf-wiki-8071b3fa33a1e32fe1ee608b586c499d20d8dc11.zip
Automated commit
Diffstat (limited to '2024/captions')
-rw-r--r--2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main--chapters.vtt59
-rw-r--r--2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main.vtt894
2 files changed, 953 insertions, 0 deletions
diff --git a/2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main--chapters.vtt b/2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main--chapters.vtt
new file mode 100644
index 00000000..9c239169
--- /dev/null
+++ b/2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main--chapters.vtt
@@ -0,0 +1,59 @@
+WEBVTT
+
+
+00:00:00.000 --> 00:02:20.079
+Introduction
+
+00:02:20.080 --> 00:04:05.479
+Starting a new writing project
+
+00:04:05.480 --> 00:04:36.959
+The writing log
+
+00:04:36.960 --> 00:05:25.309
+Starting the research paper
+
+00:05:25.310 --> 00:06:11.439
+Outline
+
+00:06:11.440 --> 00:07:17.457
+Another kind of writing log - accountability
+
+00:07:17.458 --> 00:07:46.479
+Reducing switching costs
+
+00:07:46.480 --> 00:09:31.519
+Motivation
+
+00:09:31.520 --> 00:10:17.294
+Overview of the writing log
+
+00:10:17.295 --> 00:10:42.667
+LaTeX preamble in opened drawer
+
+00:10:42.668 --> 00:12:21.399
+Informative header
+
+00:12:21.400 --> 00:13:28.079
+Four workflows
+
+00:13:28.080 --> 00:14:56.959
+Project initiation workflow
+
+00:14:56.960 --> 00:17:05.750
+Daily workflow
+
+00:17:05.751 --> 00:17:48.884
+Metadata and metacognition
+
+00:17:48.885 --> 00:18:56.959
+Periodic assessment workflow
+
+00:18:56.960 --> 00:19:49.639
+Project closeout workflow
+
+00:19:49.640 --> 00:20:34.519
+Conclusions
+
+00:20:34.520 --> 00:21:37.720
+Acknowledgements
diff --git a/2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main.vtt b/2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main.vtt
new file mode 100644
index 00000000..d728c78e
--- /dev/null
+++ b/2024/captions/emacsconf-2024-project--managing-writing-project-metadata-with-orgmode--blaine-mooers--main.vtt
@@ -0,0 +1,894 @@
+WEBVTT captioned by sachac
+
+NOTE Introduction
+
+00:00:00.000 --> 00:00:09.999
+Good morning. I'm Blaine Mooers. I'm an associate
+
+00:00:10.000 --> 00:00:12.399
+professor of biochemistry and physiology at the
+
+00:00:12.400 --> 00:00:15.079
+University of Oklahoma Health Sciences in Oklahoma City.
+
+00:00:15.080 --> 00:00:21.639
+I'm going to be talking about the utilization of Org mode to
+
+00:00:21.640 --> 00:00:26.799
+write a specific kind of log file for thinking about writing
+
+00:00:26.800 --> 00:00:31.599
+projects, in particular research articles. I have stored a
+
+00:00:31.600 --> 00:00:35.919
+template for this file on GitHub. You can find it at Mooers
+
+00:00:35.920 --> 00:00:40.759
+Lab. If you go to the landing page and scroll down to
+
+00:00:40.760 --> 00:00:47.279
+Emacs-related, you'll find a link to it.
+
+00:00:47.280 --> 00:00:50.679
+I am a structural biologist. I utilize X-ray
+
+00:00:50.680 --> 00:00:53.359
+crystallography to determine the structures of proteins
+
+00:00:53.360 --> 00:00:58.919
+and nucleic acids that are important in human health. Our
+
+00:00:58.920 --> 00:01:01.879
+workflow is shown across the top. We start out with a
+
+00:01:01.880 --> 00:01:04.959
+purified material that we crystallize as shown by that
+
+00:01:04.960 --> 00:01:09.599
+elongated rod-shaped crystal on the left. We will mount
+
+00:01:09.600 --> 00:01:14.959
+that in a cold stream and collect diffraction data with
+
+00:01:14.960 --> 00:01:20.399
+X-rays in the instrument to the right. That instrument will
+
+00:01:20.400 --> 00:01:23.559
+generate an image like the one to the right where you see a
+
+00:01:23.560 --> 00:01:26.319
+bunch of spots. That's a diffraction pattern from the
+
+00:01:26.320 --> 00:01:29.799
+crystal. After rotating the crystal for one degree, we'll
+
+00:01:29.800 --> 00:01:33.079
+rotate the crystal 180 degrees to get a full data set that
+
+00:01:33.080 --> 00:01:37.359
+we'll process with a computer. This will lead to the
+
+00:01:37.360 --> 00:01:43.719
+chicken-wire map of electron density shown further to the
+
+00:01:43.720 --> 00:01:49.999
+right. Then on the far right, we have compared
+
+00:01:50.000 --> 00:01:54.799
+electrostructures of two drug molecules from two
+
+00:01:54.800 --> 00:01:59.399
+different structures, overlapped after superimposing
+
+00:01:59.400 --> 00:02:02.919
+a wild type protein and a mutant protein. We're trying to
+
+00:02:02.920 --> 00:02:05.959
+analyze how the mutant was preventing one of the drugs from
+
+00:02:05.960 --> 00:02:12.199
+binding. These kind of analyses we can develop that are
+
+00:02:12.200 --> 00:02:16.519
+drugs. In this case, the drugs are being used to treat lung
+
+00:02:16.520 --> 00:02:20.079
+cancer.
+
+NOTE Starting a new writing project
+
+00:02:20.080 --> 00:02:24.919
+When I start a new writing project, I will assign it a number.
+
+00:02:24.920 --> 00:02:29.639
+In this case, I'm developing a review article about the
+
+00:02:29.640 --> 00:02:32.479
+detection of crystals in images collected with
+
+00:02:32.480 --> 00:02:33.861
+microscopes like the image in the upper left.
+
+00:02:33.862 --> 00:02:42.639
+The article is about the utilization of AI to help with that
+
+00:02:42.640 --> 00:02:49.039
+detection of crystals. I start the name of the folder with
+
+00:02:49.040 --> 00:02:55.079
+this index number, and I store the manuscript folders in the
+
+00:02:55.080 --> 00:02:59.159
+top level of my home directory to ease navigation.
+
+00:02:59.160 --> 00:03:03.839
+Whenever I pop open a terminal window, I just enter 0573, hit
+
+00:03:03.840 --> 00:03:07.279
+TAB to autocomplete the name of the folder, and I'll be right
+
+00:03:07.280 --> 00:03:11.599
+in the appropriate folder. I also use that index number to
+
+00:03:11.600 --> 00:03:14.879
+label the names of the files. I start every project with
+
+00:03:14.880 --> 00:03:19.519
+three files: a manuscript, the log file that I'll be talking
+
+00:03:19.520 --> 00:03:22.759
+about today, and an annotated bibliography, which is kind
+
+00:03:22.760 --> 00:03:25.999
+of like one on steroids. Annotated bibliography for the
+
+00:03:26.000 --> 00:03:30.759
+21st century, not the 20th century annotated bibliography
+
+00:03:30.760 --> 00:03:37.239
+you worked on as an undergraduate.
+
+00:03:37.240 --> 00:03:40.279
+I have developed templates not only for Org Mode, but also
+
+00:03:40.280 --> 00:03:45.359
+for other markup languages, like R Markdown and LaTeX. I
+
+00:03:45.360 --> 00:03:49.399
+actually developed this
+
+00:03:49.400 --> 00:03:54.839
+log file template over a dozen years ago in LaTeX. I also
+
+00:03:54.840 --> 00:03:58.159
+have developed it for Typst. Typst is independent of LaTeX.
+
+00:03:58.160 --> 00:04:04.079
+It's inspired by LaTeX, but it's written in Rust, and
+
+00:04:04.080 --> 00:04:05.479
+it's extremely fast.
+
+NOTE The writing log
+
+00:04:05.480 --> 00:04:11.799
+My writing process involves having the writing log at the
+
+00:04:11.800 --> 00:04:14.479
+center of the process. That's where I began the writing
+
+00:04:14.480 --> 00:04:19.679
+project. On the right, I have the manuscript and all its
+
+00:04:19.680 --> 00:04:25.839
+components highlighted in yellow. On the right,
+
+00:04:25.840 --> 00:04:29.839
+hopefully I said on the right, I have the manuscript with all
+
+00:04:29.840 --> 00:04:33.199
+its components highlighted in yellow. On the left, I have
+
+00:04:33.200 --> 00:04:36.959
+the annotated bibliography.
+
+NOTE Starting the research paper
+
+00:04:36.960 --> 00:04:42.199
+When I start a research paper, I will do this after I have
+
+00:04:42.200 --> 00:04:49.639
+built up a strong idea from various sources, and then I'll
+
+00:04:49.640 --> 00:04:54.919
+sit down and go through a series of steps outlined in the
+
+00:04:54.920 --> 00:04:59.839
+writing log to develop that central hypothesis into
+
+00:04:59.840 --> 00:05:03.839
+several paragraphs that are used in the introduction of the
+
+00:05:03.840 --> 00:05:08.159
+manuscript. The rest of the manuscript is built around that
+
+00:05:08.160 --> 00:05:11.599
+central hypothesis, so the results section will include
+
+00:05:11.600 --> 00:05:15.799
+experiments that address the central hypothesis, and it
+
+00:05:15.800 --> 00:05:19.479
+will exclude experiments that have nothing to do with it.
+
+00:05:19.480 --> 00:05:22.719
+Likewise, the discussion points address the central
+
+00:05:22.720 --> 00:05:25.309
+hypothesis.
+
+NOTE Outline
+
+00:05:25.310 --> 00:05:27.919
+When I'm done developing that introduction
+
+00:05:27.920 --> 00:05:33.439
+in, say, three or four hours, I'll have an outline in hand. At
+
+00:05:33.440 --> 00:05:38.199
+least for the results and discussion section, the outline
+
+00:05:38.200 --> 00:05:44.199
+will be detailed down to at least a sub-heading level.
+
+00:05:44.200 --> 00:05:47.239
+I'll move those components over to the manuscript on the
+
+00:05:47.240 --> 00:05:53.079
+right. As work is done to address that central
+
+00:05:53.080 --> 00:05:58.119
+hypothesis, the manuscript will be updated. Also as
+
+00:05:58.120 --> 00:06:01.359
+exploration of the literature continues, new ideas will
+
+00:06:01.360 --> 00:06:11.439
+flow in to the manuscript through the log file.
+
+NOTE Another kind of writing log - accountability
+
+00:06:11.440 --> 00:06:13.519
+You've probably heard of another kind of writing log, which
+
+00:06:13.520 --> 00:06:16.719
+is more of an accountability tool, a tool you use to hold
+
+00:06:16.720 --> 00:06:20.599
+yourself accountable in terms of your commitment to work on
+
+00:06:20.600 --> 00:06:24.716
+your writing projects.
+
+00:06:24.717 --> 00:06:28.999
+So, this idea of carrying out this
+
+00:06:29.000 --> 00:06:32.716
+documentation is supported by research done by
+
+00:06:32.717 --> 00:06:35.838
+Robert Boice. He found that those academics
+
+00:06:35.839 --> 00:06:39.100
+who record their writing
+
+00:06:39.101 --> 00:06:42.002
+are four times more productive than those that do not.
+
+00:06:42.003 --> 00:06:44.119
+Those that actually share their writing with
+
+00:06:44.120 --> 00:06:47.719
+colleagues are nine times more productive. This is sort of a
+
+00:06:47.720 --> 00:06:55.479
+case in point. This is a snapshot of a Google sheet of such a
+
+00:06:55.480 --> 00:07:03.279
+writing log that I was sharing as part of a Google workbook.
+
+00:07:03.280 --> 00:07:06.959
+I was sharing it with three other colleagues. I had the
+
+00:07:06.960 --> 00:07:14.319
+possibility of them taking a peek at my Google sheet, and that
+
+00:07:14.320 --> 00:07:17.457
+possibility I found to be highly motivating.
+
+NOTE Reducing switching costs
+
+00:07:17.458 --> 00:07:22.599
+As you can see, on July 24th, 2023, I worked on five different writing
+
+00:07:22.600 --> 00:07:25.959
+projects. This would not have been possible if it had not
+
+00:07:25.960 --> 00:07:29.399
+been for having five separate writing logs where I could
+
+00:07:29.400 --> 00:07:32.759
+figure out where I had started and where I would report the
+
+00:07:32.760 --> 00:07:36.959
+day's progress before maybe taking a break and then
+
+00:07:36.960 --> 00:07:41.199
+switching to another writing project. The writing log
+
+00:07:41.200 --> 00:07:46.479
+helps reduce switching costs between projects.
+
+NOTE Motivation
+
+00:07:46.480 --> 00:07:57.959
+My motivation for developing this project-specific log
+
+00:07:57.960 --> 00:08:02.959
+that I'm presenting here is to support clearer thinking
+
+00:08:02.960 --> 00:08:06.879
+about the science that I'm trying to do, hopefully leading
+
+00:08:06.880 --> 00:08:10.399
+to better science, as well as accelerating the completion
+
+00:08:10.400 --> 00:08:13.439
+of the writing project. The secondary purpose is to enable
+
+00:08:13.440 --> 00:08:17.719
+working on multiple writing projects in parallel. This is
+
+00:08:17.720 --> 00:08:21.799
+important to be able to harness your subconscious. If you
+
+00:08:21.800 --> 00:08:25.919
+work on project A for a few hours in the morning, say early
+
+00:08:25.920 --> 00:08:28.210
+morning, then late morning you work on project B.
+
+00:08:28.211 --> 00:08:33.860
+While you're working on project B,
+
+00:08:33.861 --> 00:08:39.141
+your subconscious is busy working away on project A.
+
+00:08:39.142 --> 00:08:43.479
+As a result, perhaps the following morning,
+
+00:08:43.480 --> 00:08:46.279
+when you wake up or while you're taking a shower or
+
+00:08:46.280 --> 00:08:51.999
+commuting, new ideas will emerge for projects A and B as a
+
+00:08:52.000 --> 00:08:55.239
+result of these background jobs that you have launched. If
+
+00:08:55.240 --> 00:08:58.799
+you don't work on project A, then you're not going to get the
+
+00:08:58.800 --> 00:09:04.319
+benefit the following morning. The side effects of using
+
+00:09:04.320 --> 00:09:07.439
+this writing log are that it reduces the fear of forgetting
+
+00:09:07.440 --> 00:09:10.199
+and also reduces the fear of losing momentum. These are two
+
+00:09:10.200 --> 00:09:14.999
+barriers to attempting to carry out work on multiple
+
+00:09:15.000 --> 00:09:19.239
+writing projects in a given day. This problem of dealing
+
+00:09:19.240 --> 00:09:22.719
+with multiple writing projects is one that is not discussed
+
+00:09:22.720 --> 00:09:26.039
+in books about writing. It's apparently a very difficult
+
+00:09:26.040 --> 00:09:29.759
+problem. I think my writing log is a successful solution to
+
+00:09:29.760 --> 00:09:31.519
+that problem.
+
+NOTE Overview of the writing log
+
+00:09:31.520 --> 00:09:39.919
+This is an overview of the writing log in Org mode. It has
+
+00:09:39.920 --> 00:09:42.959
+various components. I don't have time to go through all of
+
+00:09:42.960 --> 00:09:48.679
+them in detail, but you can see its structure. We get this
+
+00:09:48.680 --> 00:09:54.319
+summary view when you open up the file. You have this in the
+
+00:09:54.320 --> 00:10:04.119
+header for a startup command overview. Then I just click
+
+00:10:04.120 --> 00:10:08.079
+on the heading and hit TAB to see the contents below. So
+
+00:10:08.080 --> 00:10:11.439
+normally, I'm just going to go straight to the daily log.
+
+00:10:11.440 --> 00:10:17.294
+In this case, it starts on line 944.
+
+NOTE LaTeX preamble in opened drawer
+
+00:10:17.295 --> 00:10:19.255
+I don't have to scroll all the way down to it,
+
+00:10:19.256 --> 00:10:21.239
+because thanks to the support
+
+00:10:21.240 --> 00:10:27.319
+for folding of these sections in Org mode, if I open up the
+
+00:10:27.320 --> 00:10:31.319
+drawer labeled :PREAMBLE:, you can see that I have imported a
+
+00:10:31.320 --> 00:10:38.879
+number of LaTeX packages to enhance the format of the PDF
+
+00:10:38.880 --> 00:10:42.667
+file that is upon export.
+
+NOTE Informative header
+
+00:10:42.668 --> 00:10:44.319
+I have commands that are listed
+
+00:10:44.320 --> 00:10:48.999
+below at the bottom for providing a fancy header. This
+
+00:10:49.000 --> 00:10:54.519
+header has the current date as well as a running title and the
+
+00:10:54.520 --> 00:10:58.199
+current page number and total number of pages. You can see
+
+00:10:58.200 --> 00:11:04.199
+in the center the header at the start of page 2. You can see the
+
+00:11:04.200 --> 00:11:09.399
+bottom of page 1 where the page number is at the bottom of the
+
+00:11:09.400 --> 00:11:17.719
+page. These headers are very useful if you happen to print
+
+00:11:17.720 --> 00:11:22.879
+out several log files and their corresponding manuscripts
+
+00:11:22.880 --> 00:11:25.359
+and take them with you to work on them while traveling.
+
+00:11:25.360 --> 00:11:29.439
+Invariably, the pages will get intermingled, and you'll have
+
+00:11:29.440 --> 00:11:33.679
+to sort them out when you return home. These headers ease
+
+00:11:33.680 --> 00:11:39.799
+that problem. You can see that the table of contents that begin
+
+00:11:39.800 --> 00:11:44.759
+the writing log is hyperlinked to various sections. In
+
+00:11:44.760 --> 00:11:48.519
+addition to the table of contents, the log file, of course,
+
+00:11:48.520 --> 00:11:51.559
+will support various graphical objects like images,
+
+00:11:51.560 --> 00:11:56.039
+tables, equations, code listings. I also have added
+
+00:11:56.040 --> 00:12:00.279
+LaTeX support for an index, a list of acronyms, glossary,
+
+00:12:00.280 --> 00:12:04.999
+mathematical notation, and literature cited. It takes no
+
+00:12:05.000 --> 00:12:10.039
+effort to add these in, so why not have them available? These
+
+00:12:10.040 --> 00:12:12.919
+features are also available in the annotated bibliography
+
+00:12:12.920 --> 00:12:16.359
+template, which helps support making that annotated
+
+00:12:16.360 --> 00:12:21.399
+bibliography far more relevant and interesting.
+
+NOTE Four workflows
+
+00:12:21.400 --> 00:12:28.079
+This shows a list of four workflows that I'm going to
+
+00:12:28.080 --> 00:12:32.599
+discuss, since I don't have time to go through each
+
+00:12:32.600 --> 00:12:36.279
+of the items. Obviously, project initiation
+
+00:12:36.280 --> 00:12:39.719
+occurs on day one. If I have a three- or four-hour block of time,
+
+00:12:39.720 --> 00:12:45.759
+that's sufficient to finish project initiation. Then
+
+00:12:45.760 --> 00:12:49.359
+the daily workflow is obviously what occurs every day to
+
+00:12:49.360 --> 00:12:54.239
+move the project forward. The periodic assessments are
+
+00:12:54.240 --> 00:12:57.079
+done on a monthly or weekly basis, generally on the weekly
+
+00:12:57.080 --> 00:13:02.559
+basis as the submission deadline approaches. Then
+
+00:13:02.560 --> 00:13:05.639
+after you have received the galley proofs and sent them
+
+00:13:05.640 --> 00:13:09.839
+back, there are a few chores that need to be done in terms of
+
+00:13:09.840 --> 00:13:13.959
+project closeout. This is an example of a protocol
+
+00:13:13.960 --> 00:13:18.519
+that could be followed to do that, and an example of the kinds
+
+00:13:18.520 --> 00:13:21.799
+of more or less appendix material that could be included in
+
+00:13:21.800 --> 00:13:28.079
+the writing log to help get these things done.
+
+NOTE Project initiation workflow
+
+00:13:28.080 --> 00:13:31.679
+This shows a project initiation section of the workflow.
+
+00:13:31.680 --> 00:13:39.119
+I go through a series of sections that include advice
+
+00:13:39.120 --> 00:13:45.719
+about what I need to do to complete each section. The
+
+00:13:45.720 --> 00:13:50.759
+rationale section asks me like, why are you doing this? Why
+
+00:13:50.760 --> 00:13:54.319
+should you do this? Why not somebody else? Those sort of
+
+00:13:54.320 --> 00:14:01.287
+fundamental questions. Then I have
+
+00:14:01.288 --> 00:14:05.329
+a drawer labeled guidance that I have,
+
+00:14:05.330 --> 00:14:07.190
+and that headline immediately above,
+
+00:14:07.191 --> 00:14:11.839
+I have this :noexport: keyword so that guidance is not
+
+00:14:11.840 --> 00:14:17.039
+written out upon export to the PDF unless you want it. If you
+
+00:14:17.040 --> 00:14:20.439
+want it, you have to remove the :noexport: tag. Then I have the
+
+00:14:20.440 --> 00:14:25.199
+response to these questions--in this case, a list of
+
+00:14:25.200 --> 00:14:29.199
+journals that I'm targeting for submission of this review
+
+00:14:29.200 --> 00:14:32.959
+article. I have a plan B journal picked out in case the
+
+00:14:32.960 --> 00:14:43.399
+editors decide to reject it. Having a plan B journal
+
+00:14:43.400 --> 00:14:47.999
+picked out is a decision you can make at the time of
+
+00:14:48.000 --> 00:14:55.959
+submission, so that you're prepared to move quickly if the
+
+00:14:55.960 --> 00:14:56.959
+article is rejected.
+
+NOTE Daily workflow
+
+00:14:56.960 --> 00:15:04.639
+This shows the daily workflow section. Each entry has a
+
+00:15:04.640 --> 00:15:09.439
+date. I sometimes annotate the dated entries with a small
+
+00:15:09.440 --> 00:15:14.479
+phrase to highlight certain events. Within a given entry,
+
+00:15:14.480 --> 00:15:17.319
+I'll have a list of accomplishments. That's sort of the bare
+
+00:15:17.320 --> 00:15:20.719
+minimum of what I include. This just demonstrates how
+
+00:15:20.720 --> 00:15:25.639
+relatively brief these entries are. Just whatever
+
+00:15:25.640 --> 00:15:30.599
+distinct accomplishments were made are listed.
+
+00:15:30.600 --> 00:15:37.239
+Sometimes I'll include the goals for that day.
+
+00:15:37.240 --> 00:15:40.599
+I'll always include the correspondence related to the
+
+00:15:40.600 --> 00:15:44.439
+project. I'll copy and paste an email into a quote
+
+00:15:44.440 --> 00:15:49.719
+environment from LaTeX.
+
+00:15:49.720 --> 00:15:54.319
+I have a snippet template for auto-generating these
+
+00:15:54.320 --> 00:15:59.919
+entries. It will insert the date, for example, in the
+
+00:15:59.920 --> 00:16:04.239
+subheading. Then below that, I'll have the next action,
+
+00:16:04.240 --> 00:16:06.919
+following David Allen's Getting Things Done approach
+
+00:16:06.920 --> 00:16:08.550
+where you identify the next thing that needs to be done.
+
+00:16:08.551 --> 00:16:14.759
+That may have come from a to-do list that's indicated below that.
+
+00:16:14.760 --> 00:16:19.039
+Beyond that, there's sections for some writing
+
+00:16:19.040 --> 00:16:23.919
+accountability, and then a reminder to go about updating
+
+00:16:23.920 --> 00:16:28.919
+your Zettelkasten and Org-roam if you have come across any
+
+00:16:28.920 --> 00:16:32.359
+nuggets of knowledge you want to add to your Org-roam. Then
+
+00:16:32.360 --> 00:16:38.999
+below that, there's another section for the storage of
+
+00:16:39.000 --> 00:16:42.919
+additions to be made to the manuscript. Maybe they're not
+
+00:16:42.920 --> 00:16:47.599
+ready to go yet, so this provides a spot for them to be
+
+00:16:47.600 --> 00:16:51.599
+incubated, a sandbox, if you will, where you have room to
+
+00:16:51.600 --> 00:16:53.239
+develop them further before they're ready to be
+
+00:16:53.240 --> 00:16:58.399
+transferred over to the main manuscript. I also have a
+
+00:16:58.400 --> 00:17:04.239
+section there too for the incubation of new ideas for new
+
+00:17:04.240 --> 00:17:05.750
+projects.
+
+NOTE Metadata and metacognition
+
+00:17:05.751 --> 00:17:09.639
+So this kind of metadata and metacognition about
+
+00:17:09.640 --> 00:17:13.759
+the project are often stored in commented out regions or in
+
+00:17:13.760 --> 00:17:18.039
+comments, like MS Word documents. These are often stripped
+
+00:17:18.040 --> 00:17:21.839
+out in the rush to submit the manuscript, and they're quite
+
+00:17:21.840 --> 00:17:26.479
+often lost. Yet they can be invaluable, not only for the
+
+00:17:26.480 --> 00:17:30.239
+preparation of future manuscripts, but they can be very
+
+00:17:30.240 --> 00:17:38.279
+invaluable for responding to critiques by reviewers. This
+
+00:17:38.280 --> 00:17:42.839
+writing log provides ample room for the safe storage of such
+
+00:17:42.840 --> 00:17:48.884
+information, such knowledge.
+
+NOTE Periodic assessment workflow
+
+00:17:48.885 --> 00:17:53.666
+Then periodically, every several months or weeks,
+
+00:17:53.667 --> 00:17:55.159
+we'll carry out an assessment of
+
+00:17:55.160 --> 00:18:02.119
+the project. We go through a checklist for the completion of
+
+00:18:02.120 --> 00:18:06.319
+the manuscript. We also have a timeline with milestones
+
+00:18:06.320 --> 00:18:07.439
+identified.
+
+00:18:07.440 --> 00:18:13.759
+Of course, Org has these wonderful tables that are very
+
+00:18:13.760 --> 00:18:18.879
+dynamic. If you need a wider column to accommodate a new
+
+00:18:18.880 --> 00:18:23.359
+entry, it self-adjusts. These self-adjusting tables
+
+00:18:23.360 --> 00:18:29.639
+are one reason why I was attracted to Org mode, because coming
+
+00:18:29.640 --> 00:18:33.039
+from LaTex, where trying to make changes to
+
+00:18:33.040 --> 00:18:36.999
+tables is quite difficult. Below that, there's a
+
+00:18:37.000 --> 00:18:39.639
+section to make assessments. There are four questions that
+
+00:18:39.640 --> 00:18:43.839
+I address about the status of the project. One really good
+
+00:18:43.840 --> 00:18:46.559
+question is, why can't you submit this project today?
+
+00:18:46.560 --> 00:18:49.350
+What's holding it back?
+
+00:18:49.351 --> 00:18:55.214
+Other such existential questions
+
+00:18:55.215 --> 00:18:56.959
+are important to ask from time to time.
+
+NOTE Project closeout workflow
+
+00:18:56.960 --> 00:19:03.633
+Then finally, the project closeout workflow.
+
+00:19:03.634 --> 00:19:06.477
+So this is in the form of a checklist.
+
+00:19:06.478 --> 00:19:09.079
+This checklist in the main template
+
+00:19:09.080 --> 00:19:13.479
+is already included, but you could include it from an
+
+00:19:13.480 --> 00:19:19.959
+external file. Of course, that checklist will be only in
+
+00:19:19.960 --> 00:19:22.799
+the PDF when it's included in this fashion. It won't be in the
+
+00:19:22.800 --> 00:19:27.599
+Org file, but you can view that checklist by clicking on its
+
+00:19:27.600 --> 00:19:32.719
+file path. It serves as a link that will open up in an Org
+
+00:19:32.720 --> 00:19:40.119
+buffer. The advantage of taking a modular approach to this
+
+00:19:40.120 --> 00:19:42.999
+sort of appendix material is that you can update your
+
+00:19:43.000 --> 00:19:46.399
+protocols and the updated protocols will be available to
+
+00:19:46.400 --> 00:19:49.639
+all log files across all projects.
+
+NOTE Conclusions
+
+00:19:49.640 --> 00:19:56.319
+In conclusion, this project-specific log file helps
+
+00:19:56.320 --> 00:20:02.759
+narrow the focus on one project. It provides space to harbor
+
+00:20:02.760 --> 00:20:08.679
+the thinking about that project, and it helps support the
+
+00:20:08.680 --> 00:20:13.999
+project initiation and sustain its momentum and
+
+00:20:14.000 --> 00:20:21.799
+facilitate its completion. The side effects of using this
+
+00:20:21.800 --> 00:20:27.399
+log file for one project is that it dampens the fear of
+
+00:20:27.400 --> 00:20:31.439
+forgetting, the fear of losing momentum, which inhibits us
+
+00:20:31.440 --> 00:20:34.519
+working on more than one project in a given day.
+
+NOTE Acknowledgements
+
+00:20:34.520 --> 00:20:42.559
+I would like to thank my friends at the Oklahoma Data Science
+
+00:20:42.560 --> 00:20:47.799
+Workshop. We hold this workshop every third Friday at noon
+
+00:20:47.800 --> 00:20:53.759
+central time by Zoom. It's open to participation by people
+
+00:20:53.760 --> 00:20:56.879
+from all around the world. Send me an email if you are
+
+00:20:56.880 --> 00:21:01.519
+interested in the applications of computing to scientific
+
+00:21:01.520 --> 00:21:06.799
+research. I participate occasionally in these Emacs
+
+00:21:06.800 --> 00:21:11.359
+meetups, and I have shared this writing blog with members of
+
+00:21:11.360 --> 00:21:18.719
+the UK Research Software Engineer group through the Emacs
+
+00:21:18.720 --> 00:21:24.279
+Research Slack channel. My efforts are supported by
+
+00:21:24.280 --> 00:21:28.799
+funding from these grants. I'll be happy to take any
+
+00:21:28.800 --> 00:21:37.720
+questions.