Skip to content

Commit 200a187

Browse files
authored
fix quota quote (#34)
* fix quota quote * whitespace * add info on machine types
1 parent 60e15fd commit 200a187

2 files changed

Lines changed: 53 additions & 12 deletions

File tree

source/ch-coding.ptx

Lines changed: 42 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -296,10 +296,11 @@ there is the option to pay for additional resources.
296296
<p>
297297
As a mathematician
298298
who almost exclusively uses GitHub Codespaces for doing the kinds
299-
of work described in this handbook,
300-
I've found that I often approach the quota provided
301-
for Pro users, but have
302-
not yet exceeded it. I accomplish this by being sure to not run
299+
of work described in this handbook (and does so for much longer
300+
periods of time than a tpyical mathematician),
301+
I've only surpassed GitHub's free quota on the rare occassion
302+
(and when I do, I've paid only \$2-\$6 per month).
303+
I accomplish this by halting
303304
my Codespaces when I'm not actively working on them.
304305
</p>
305306
<note xml:id="note-manage-codespaces">
@@ -326,14 +327,43 @@ A deleted Codespace can always be recreated later based upon your most
326327
recent commit.
327328
</p>
328329
</note>
329-
<p>Putting it all together, we have seen three ways to access files on your repo.
330-
Going from the least easy to edit to the most editable we have: <c>GitHub.com</c>, <c>GitHub.dev</c>, <c>random-codespace-string.github.dev</c>. Here is what these environments look like.</p>
331-
<figure xml:id="fig-faces-of-github">
332-
<image width="100%" source="screenshots/github-com.png"/>
333-
<image width="100%" source="screenshots/github-dev.png"/>
334-
<image width="100%" source="screenshots/github-codespace.png"/>
335-
<caption>Repo from different points of view.</caption>
336-
</figure>
330+
<p>
331+
Putting it all together, we have seen three ways to access files on your repo.
332+
Going from the least easy to edit to the most editable we have: <c>GitHub.com</c>,
333+
<c>GitHub.dev</c>, <c>random-codespace-string.github.dev</c>.
334+
Here is what these environments look like.
335+
</p>
336+
<figure xml:id="fig-faces-of-github">
337+
<image width="100%" source="screenshots/github-com.png"/>
338+
<image width="100%" source="screenshots/github-dev.png"/>
339+
<image width="100%" source="screenshots/github-codespace.png"/>
340+
<caption>Repo from different points of view.</caption>
341+
</figure>
342+
</section>
343+
<section xml:id="sec-powering-up-your-codespce">
344+
<title>Powering up your Codespce</title>
345+
<p>
346+
By default, your codespace will use a
347+
2-core processor, 8GB of RAM, and 32GB of storage, with a quota of
348+
40 usage hours per month. This is fine for many tasks,
349+
but if you're doing data analysis (<xref ref="ch-jupyter"/>) or
350+
formalized mathematics (<xref ref="sec-lean"/>) you may want some
351+
more resources at your disposal.
352+
</p>
353+
<remark xml:id="remark-change-machine-type">
354+
<p>
355+
You can double (or quadruple, or <m>8\times</m>, etc.) your resources
356+
by <q>changing the machine type</q>. There are several ways to accomplish
357+
this, via <url href="https://github.com/codespaces/"/>, or by typing
358+
<q>Change Machine Type</q> in the Codespace command pallette
359+
(accessed via <kbd>Ctrl/Cmd</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>).
360+
</p>
361+
<p>
362+
Note however, that if you double your resources, you are also doubling your
363+
usage time (e.g. running a 4-core machine uses one hour of your quota
364+
every 30 minutes).
365+
</p>
366+
</remark>
337367
</section>
338368
<section xml:id="sec-custom-codespaces">
339369
<title>Custom Codespaces</title>

source/ch-jupyter.ptx

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,17 @@ I've provided a
133133
that you can upload to your Codespace to experiment with.
134134
</p>
135135
</section>
136+
<section xml:id="sec-big-data">
137+
<title>Handling big datasets</title>
138+
<p>
139+
A (possible) disadvantage of using Codespaces compared to your
140+
own computer is that all processing happens in the cloud, so
141+
you're limited by the resources made available to you by
142+
GitHub. But <xref ref="remark-change-machine-type"/> describes
143+
how to beef up your Codespace with more resources, should you
144+
need to crunch a particularly large dataset.
145+
</p>
146+
</section>
136147
<section xml:id="sec-r-jupyter">
137148
<title>Using R with Jupyter</title>
138149
<p>

0 commit comments

Comments
 (0)