Skip to content

Commit fbf5137

Browse files
author
GitHub Workshop Bot
committed
Rebuild HTML from updated markdown files
1 parent 06c0903 commit fbf5137

File tree

8 files changed

+436
-183
lines changed

8 files changed

+436
-183
lines changed

html/CHALLENGE_SYSTEM_ARCHITECTURE.html

Lines changed: 253 additions & 111 deletions
Large diffs are not rendered by default.

html/README.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,8 @@ <h2>A Workshop by <a href="https://community-access.org">Community Access</a></h
4848
<td><a href="https://community-access.org/git-going-with-github/">community-access.org/git-going-with-github</a></td>
4949
</tr>
5050
<tr>
51-
<td><strong>Register</strong></td>
52-
<td><a href="https://community-access.org/git-going-with-github/REGISTER.html">Register for the workshop</a> (75 seats, free, two steps)</td>
51+
<td><strong>Registration</strong></td>
52+
<td>Closed - thank you to all who registered!</td>
5353
</tr>
5454
<tr>
5555
<td><strong>Discussions</strong></td>

html/REGISTER.html

Lines changed: 54 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,8 @@
3131
<main id="main-content" class="markdown-body">
3232
<h1>Registration Closed</h1>
3333
<p><a href="https://community-access.org/git-going-with-github/">Back to Home</a> | <a href="https://github.com/community-access/git-going-with-github/discussions">Discussion Forum</a> | <a href="https://community-access.org/git-going-with-github/docs/00-pre-workshop-setup.html">Pre-Workshop Setup Guide</a></p>
34-
<p>Registration for GIT Going with GitHub is now closed. Thank you to everyone who registered - let the learning begin!</p>
34+
<h2>Registration for GIT Going with GitHub is now closed.</h2>
35+
<p>Thank you to everyone who registered! We are excited to learn together.</p>
3536
<table>
3637
<thead>
3738
<tr>
@@ -41,7 +42,7 @@ <h1>Registration Closed</h1>
4142
</thead>
4243
<tbody><tr>
4344
<td><strong>Dates</strong></td>
44-
<td>Saturday, March 7 &amp; Sunday, March 8, 2026</td>
45+
<td>Saturday, March 7 and Sunday, March 8, 2026</td>
4546
</tr>
4647
<tr>
4748
<td><strong>Time</strong></td>
@@ -57,8 +58,36 @@ <h1>Registration Closed</h1>
5758
</tr>
5859
</tbody></table>
5960
<hr>
60-
<h2>Already Registered?</h2>
61-
<p>Complete the <a href="https://community-access.org/git-going-with-github/docs/00-pre-workshop-setup.html"><strong>Pre-Workshop Setup Guide</strong></a> before March 7. It walks you through GitHub account setup, screen reader configuration, <a href="https://code.visualstudio.com/">VS Code</a>, and <a href="https://github.com/features/copilot">GitHub Copilot</a> - with instructions for NVDA, JAWS, and VoiceOver.</p>
61+
<p><strong>Already registered?</strong> Complete the <a href="https://community-access.org/git-going-with-github/docs/00-pre-workshop-setup.html"><strong>Pre-Workshop Setup Guide</strong></a> before March 7. It walks you through GitHub account setup, screen reader configuration, <a href="https://code.visualstudio.com/">VS Code</a>, and <a href="https://github.com/features/copilot">GitHub Copilot</a> - with instructions for NVDA, JAWS, and VoiceOver.</p>
62+
<hr>
63+
<h3>Questions?</h3>
64+
<p>Need help? <a href="https://github.com/community-access/git-going-with-github/issues">File an issue</a> in the workshop repository or join the <a href="https://github.com/community-access/git-going-with-github/discussions">Discussion Forum</a>.</p>
65+
<p><em>A <a href="https://community-access.org">Community Access</a> initiative.</em></p>
66+
<p><strong>Important:</strong> You must be signed into your GitHub account before clicking the link below. If you are not signed in, go to <a href="https://github.com">GitHub</a> and sign in first.</p>
67+
<blockquote>
68+
<p><a href="https://github.com/community-access/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+GIT+Going+with+GitHub+-+March+2026"><strong>Start Step 2 - File your registration issue</strong></a></p>
69+
</blockquote>
70+
<p><strong>Note:</strong> The issue title is pre-filled and required by GitHub. You do not need to change it - just fill out the form fields below it and submit.</p>
71+
<p>The form asks for:</p>
72+
<ul>
73+
<li><strong>First Name</strong> (required) - your first name as you would like to be addressed during the workshop</li>
74+
<li><strong>Last Name</strong> (required)</li>
75+
<li><strong>Email Address</strong> (required) - we will use this to send you Zoom links and workshop materials before the event</li>
76+
<li><strong>GitHub Proficiency Level</strong> (required) - a dropdown from &quot;Brand new&quot; to &quot;Experienced&quot; so we can prepare the right level of support</li>
77+
<li><strong>Primary Screen Reader</strong> (optional) - which screen reader you primarily use (NVDA, JAWS, VoiceOver, or other)</li>
78+
<li><strong>Questions or Accommodations</strong> (optional) - anything we should know or arrange before the workshop</li>
79+
</ul>
80+
<p>After you submit, you will receive an automated confirmation comment on your issue. Your GitHub username is captured automatically - you do not need to enter it.</p>
81+
<hr>
82+
<h2>What Happens Next</h2>
83+
<p>Once you have completed both steps:</p>
84+
<ol>
85+
<li>You will receive a Zoom confirmation email (Step 1)</li>
86+
<li>You will see a confirmation comment on your GitHub issue (Step 2)</li>
87+
<li>Complete the <a href="https://community-access.org/git-going-with-github/docs/00-pre-workshop-setup.html">Pre-Workshop Setup Guide</a> before March 7 - it covers GitHub account setup, screen reader configuration, <a href="https://code.visualstudio.com/">VS Code</a>, and <a href="https://github.com/features/copilot">GitHub Copilot</a></li>
88+
<li>Questions? <a href="https://github.com/community-access/git-going-with-github/issues">File an issue</a> in the workshop repository</li>
89+
</ol>
90+
<hr>
6291
<h2>While You Wait</h2>
6392
<ul>
6493
<li><a href="https://github.com/community-access/git-going-with-github/discussions"><strong>Join the Discussion Forum</strong></a> - introduce yourself, ask questions, and connect with fellow participants before Day 1</li>
@@ -72,5 +101,25 @@ <h2>While You Wait</h2>
72101
<p><strong>GIT Going with GitHub</strong> - A workshop by <a href="https://community-access.org">Community Access</a></p>
73102
<p><a href="https://github.com/community-access/git-going-with-github">View on GitHub</a> · <a href="https://community-access.org">community-access.org</a></p>
74103
</footer>
75-
</body>
104+
<script>
105+
(function() {
106+
var url = 'https://api.github.com/search/issues?q=repo:community-access/git-going-with-github+label:registration+is:issue+is:open';
107+
var xhr = new XMLHttpRequest();
108+
xhr.open('GET', url);
109+
xhr.setRequestHeader('Accept', 'application/vnd.github+json');
110+
xhr.onload = function() {
111+
if (xhr.status === 200) {
112+
try {
113+
var count = JSON.parse(xhr.responseText).total_count;
114+
var els = document.querySelectorAll('[id^="registration-count"]');
115+
for (var i = 0; i < els.length; i++) {
116+
els[i].textContent = count;
117+
}
118+
} catch (e) {}
119+
}
120+
};
121+
xhr.onerror = function() {};
122+
xhr.send();
123+
})();
124+
</script></body>
76125
</html>

html/docs/00-pre-workshop-setup.html

Lines changed: 15 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,7 @@ <h3>Software - Day 1</h3>
7676
<h3>Software - Required Before the Workshop</h3>
7777
<ul>
7878
<li><strong>Git</strong> - <a href="https://git-scm.com/downloads">Download Git</a> (Windows/Linux) or Xcode Command Line Tools (macOS)</li>
79-
<li><strong>Visual Studio Code</strong> (free) - <a href="https://code.visualstudio.com/">download here</a></li>
80-
<li><strong>GitHub Copilot Chat</strong> extension for VS Code - installed from within VS Code (this single extension provides both inline suggestions and Chat)</li>
79+
<li><strong>Visual Studio Code</strong> (free) - <a href="https://code.visualstudio.com/">download here</a> (GitHub Copilot is included automatically)</li>
8180
<li>A GitHub Copilot subscription or Free tier access (Copilot Free is available to all GitHub users)</li>
8281
</ul>
8382
<h3>Screen Reader Options</h3>
@@ -691,66 +690,26 @@ <h3>Using the Correct Email</h3>
691690
<p>Use the same email you registered with GitHub. If you&#39;re concerned about privacy, GitHub offers a no-reply email you can use: <code>username@users.noreply.github.com</code> - find it in <a href="https://github.com/settings/emails">Settings → Emails</a>.</p>
692691
<hr>
693692
<h2>Step 8 - Install VS Code Extensions</h2>
694-
<p>This workshop uses two VS Code extensions. Both are published by GitHub and are free. Install them in the order shown below.</p>
693+
<p>This workshop uses two VS Code extensions. GitHub Copilot is built into VS Code automatically. The GitHub Pull Requests extension needs to be installed manually. Both authenticate through your browser session - if you are signed into GitHub in your web browser, VS Code picks up the session automatically.</p>
695694
<hr>
696-
<h3>Sign in to GitHub in VS Code first</h3>
697-
<p>Both extensions require you to be signed into GitHub. Do this once and both will be authenticated.</p>
695+
<h3>GitHub Copilot (Built In)</h3>
696+
<p>GitHub Copilot is automatically included with Visual Studio Code. There is no extension to install separately. It provides both inline code completions and the conversational Agent mode panel used throughout the second half of the workshop.</p>
697+
<h4>Activate Copilot</h4>
698698
<ol>
699-
<li>Open VS Code</li>
700-
<li>Press <code>Ctrl+Shift+P</code> to open the Command Palette</li>
701-
<li>Type: <code>sign in</code> and arrow down to <strong>&quot;GitHub: Sign in&quot;</strong> - press <code>Enter</code><ul>
702-
<li>Your default web browser will open to a GitHub authentication page</li>
703-
</ul>
704-
</li>
705-
<li>In the browser, confirm your GitHub account when prompted and select <strong>Authorize Visual Studio Code</strong></li>
706-
<li>Switch back to VS Code - your browser may ask you to confirm opening VS Code; select <strong>Open</strong> or <strong>Allow</strong></li>
707-
<li>You should hear VS Code announce a notification, and the accounts icon in the Activity Bar will show your GitHub username</li>
708-
</ol>
709-
<blockquote>
710-
<p><strong>Screen reader note:</strong> The authentication happens in your browser. After authorizing, your browser will show a page saying &quot;You can close this tab and return to VS Code.&quot; Switch back to VS Code with <code>Alt+Tab</code> (Windows) or <code>Cmd+Tab</code> (macOS).</p>
711-
</blockquote>
712-
<hr>
713-
<h3>Extension 1 - GitHub Copilot Chat</h3>
714-
<p>This single extension provides both inline code completions and the conversational Chat panel. It is used throughout the second half of the workshop.</p>
715-
<h4>Install</h4>
716-
<ol>
717-
<li>Press <code>Ctrl+Shift+X</code> to open the Extensions panel<ul>
718-
<li>Your screen reader will announce &quot;Extensions&quot; and place focus in the search box</li>
719-
</ul>
720-
</li>
721-
<li>Type: <code>GitHub Copilot Chat</code><ul>
722-
<li>The list updates as you type</li>
723-
</ul>
724-
</li>
725-
<li>Press <code>Tab</code> to move from the search box into the results list</li>
726-
<li>Arrow down through the results. Look for <strong>&quot;GitHub Copilot Chat&quot;</strong> with publisher <strong>&quot;GitHub&quot;</strong><ul>
727-
<li>There are similar-named extensions from other publishers - verify the publisher is &quot;GitHub&quot; before installing</li>
728-
</ul>
729-
</li>
730-
<li>Press <code>Enter</code> to open the extension details page</li>
731-
<li>Press <code>Tab</code> to find the <strong>Install</strong> button, then press <code>Enter</code> or <code>Space</code></li>
732-
<li>Wait for installation to complete - VS Code will announce &quot;Extension installed&quot; or similar</li>
733-
</ol>
734-
<h4>Verify it is working</h4>
735-
<ol>
736-
<li>Press <code>Ctrl+Shift+I</code> to open the Copilot Chat panel<ul>
699+
<li>Make sure Screen Reader Mode is enabled (see above)</li>
700+
<li>Make sure you are signed into GitHub in your web browser</li>
701+
<li>Press <code>Ctrl+Shift+I</code> to open Agent mode<ul>
737702
<li>Your screen reader should announce the chat input field</li>
738703
</ul>
739704
</li>
740-
<li>Type: <code>Hello, are you there?</code> and press <code>Enter</code></li>
705+
<li>Type: <code>Hello</code> and press <code>Enter</code></li>
706+
<li>VS Code will automatically sign you into GitHub Copilot using your browser session - no manual sign-in command is needed</li>
741707
<li>A response will appear in the chat history above the input field</li>
742708
<li>Navigate up with <code>Shift+Tab</code> or <code>Up Arrow</code> to read the response</li>
743-
<li>If you see an error about signing in, press <code>Ctrl+Shift+P</code> and run <strong>&quot;GitHub: Sign in&quot;</strong> again</li>
744-
</ol>
745-
<h4>Verify inline completions</h4>
746-
<ol>
747-
<li>Press <code>Ctrl+N</code> to create a new untitled file</li>
748-
<li>Press <code>Ctrl+Shift+P</code>, type <code>change language</code>, and select <strong>&quot;Change Language Mode&quot;</strong> - choose <strong>Python</strong> or <strong>JavaScript</strong></li>
749-
<li>Start typing a function name such as <code>function greet</code> (JavaScript) or <code>def greet</code> (Python)</li>
750-
<li>Pause for 1-2 seconds - Copilot will suggest a completion in grey ghost text</li>
751-
<li>Press <code>Tab</code> to accept it, or <code>Esc</code> to dismiss</li>
752-
<li>If no suggestions appear: confirm Copilot icon shows in the status bar and that you are signed in</li>
753709
</ol>
710+
<blockquote>
711+
<p><strong>That is it.</strong> You do not need to use the Command Palette to sign in. If you are logged into GitHub in your browser, VS Code handles authentication automatically when you first interact with the agent.</p>
712+
</blockquote>
754713
<hr>
755714
<h3>Extension 2 - GitHub Pull Requests</h3>
756715
<p>This extension lets you review and manage pull requests without leaving VS Code. It is used in the code review chapters.</p>
@@ -817,10 +776,8 @@ <h2>Step 9 - Verification Checklist</h2>
817776
[ ] Git identity configured (git config --global user.name and user.email)
818777
[ ] Visual Studio Code installed
819778
[ ] Screen Reader Mode enabled in VS Code (Shift+Alt+F1 or Command Palette)
820-
[ ] Signed into GitHub in VS Code
821-
[ ] GitHub Copilot Chat extension installed (publisher: GitHub)
822-
[ ] Copilot Chat responds in the Chat panel (Ctrl+Shift+I)
823-
[ ] Copilot inline suggestions appear when typing in a file
779+
[ ] Signed into GitHub in your web browser
780+
[ ] GitHub Copilot responds in Agent mode (Ctrl+Shift+I, type Hello, get a response)
824781
[ ] GitHub Pull Requests extension installed (publisher: GitHub)
825782
[ ] Pull Requests panel opens (Ctrl+Shift+P → &quot;Focus on Pull Requests View&quot;)</code></pre>
826783
<hr>

html/docs/04-working-with-issues.html

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,30 @@ <h3>Learning Pattern Used in This Chapter</h3>
9696
<li>Leave clear evidence in the issue timeline.</li>
9797
<li>Build momentum for PR work in Chapter 5.</li>
9898
</ol>
99+
<hr>
100+
<h2>Local Git Alternative: Working from Your Clone</h2>
101+
<details>
102+
<summary>If you cloned the learning-room in Block 0 and prefer working locally</summary>
103+
104+
<p>During Block 0 you cloned the Learning Room repository to your computer. If you are comfortable in a terminal, you can use the GitHub CLI (<code>gh</code>) from inside that clone for every issue operation in this chapter. This is the same workflow covered in depth in <a href="11-git-source-control.html">Chapter 11: Git and Source Control</a>.</p>
105+
<p><strong>Verify your clone is ready:</strong></p>
106+
<pre><code class="hljs language-bash"><span class="hljs-built_in">cd</span> ~/Documents/learning-room <span class="hljs-comment"># or wherever you cloned it</span>
107+
git status <span class="hljs-comment"># should show &quot;On branch main&quot;</span></code></pre>
108+
<p><strong>Common issue commands from your local terminal:</strong></p>
109+
<pre><code class="hljs language-bash"><span class="hljs-comment"># List your assigned challenge issues</span>
110+
gh issue list --assignee @me --label challenge
111+
112+
<span class="hljs-comment"># View a specific issue in the terminal</span>
113+
gh issue view 42
114+
115+
<span class="hljs-comment"># Leave a comment on an issue</span>
116+
gh issue comment 42 --body <span class="hljs-string">&quot;I&#x27;d like to try this!&quot;</span>
117+
118+
<span class="hljs-comment"># Create a new issue interactively</span>
119+
gh issue create</code></pre>
120+
<p>All of these produce the same result as the web interface. The chapter instructions work identically either way - choose whichever is more comfortable for you.</p>
121+
</details>
122+
99123
<hr>
100124
<h2>What Is a GitHub Issue?</h2>
101125
<p>An issue is a discussion thread attached to a repository. Issues are used for:</p>

html/docs/05-working-with-pull-requests.html

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,37 @@ <h3>Why this feels achievable</h3>
9191
<li>Feedback is immediate and specific.</li>
9292
<li>Success is visible (green checks + closed issue).</li>
9393
</ul>
94+
<hr>
95+
<h2>Local Git Alternative: The Full Branch-Edit-PR Workflow</h2>
96+
<details>
97+
<summary>If you cloned the learning-room in Block 0 and prefer working locally</summary>
98+
99+
<p>The web editor workflow (pencil button, &quot;Propose changes&quot;) is the primary path taught in this chapter. If you cloned the Learning Room in Block 0 and are comfortable in a terminal, here is the local equivalent. This is the same workflow covered in depth in <a href="11-git-source-control.html">Chapter 11: Git and Source Control</a>.</p>
100+
<p><strong>Step 1 - Sync and create a feature branch:</strong></p>
101+
<pre><code class="hljs language-bash"><span class="hljs-built_in">cd</span> ~/Documents/learning-room
102+
git checkout main
103+
git pull origin main
104+
git checkout -b fix/welcome-todos</code></pre>
105+
<p><strong>Step 2 - Edit the file in your editor:</strong></p>
106+
<p>Open the file in VS Code or your preferred editor:</p>
107+
<pre><code class="hljs language-bash">code docs/welcome.md</code></pre>
108+
<p>Make your changes and save the file.</p>
109+
<p><strong>Step 3 - Stage, commit, and push:</strong></p>
110+
<pre><code class="hljs language-bash">git add docs/welcome.md
111+
git commit -m <span class="hljs-string">&quot;Complete TODO sections in welcome.md&quot;</span>
112+
git push -u origin fix/welcome-todos</code></pre>
113+
<p><strong>Step 4 - Open a pull request:</strong></p>
114+
<pre><code class="hljs language-bash">gh <span class="hljs-built_in">pr</span> create --title <span class="hljs-string">&quot;Complete TODO sections in welcome.md&quot;</span> \
115+
--body <span class="hljs-string">&quot;Closes #42&quot;</span> --base main</code></pre>
116+
<p>Or open interactively:</p>
117+
<pre><code class="hljs language-bash">gh <span class="hljs-built_in">pr</span> create</code></pre>
118+
<p>The GitHub CLI walks you through title, body, base branch, and reviewers.</p>
119+
<p><strong>What happens next is identical:</strong> the Learning Room bot validates your PR, posts feedback, and you request a human reviewer - the same as the web workflow.</p>
120+
<blockquote>
121+
<p><strong>Tip:</strong> You can also use your <code>username-practice</code> branch instead of creating a feature branch. Switch to it with <code>git checkout username-practice</code> (replacing <code>username</code> with your GitHub username, all lowercase).</p>
122+
</blockquote>
123+
</details>
124+
94125
<hr>
95126
<h2>What Is a Pull Request?</h2>
96127
<p>A pull request (PR) is a proposal to merge changes from one branch into another. When you have:</p>

0 commit comments

Comments
 (0)