Skip to content

Commit 9304f87

Browse files
authored
blog: re-upload some contributor training videos, fixes #217 (#495)
1 parent 3a5e992 commit 9304f87

File tree

3 files changed

+35
-25
lines changed

3 files changed

+35
-25
lines changed

src/content/blog/golang-debugging.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ categories:
1717
It's not hard to work with DDEV's Go code, but you definitely need a development environment and the know-how to do step-debugging. Here's our [Contributor Training](contributor-training.md) showing some of the nuances with DDEV, followed by a short summary of the details.
1818

1919
<div class="video-container">
20-
<iframe width="560" height="315" src="https://www.youtube.com/embed/E-AEzC1p76E?si=XYP23HYcxgqiJ2_M" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
20+
<iframe width="560" height="315" src="https://www.youtube.com/embed/MZkgTjWRJLM?si=jO_BWehQx_-EDiEl" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
2121
</div>
2222

2323
First, you need some of the basics:

src/content/blog/setting-up-a-go-development-environment.md

Lines changed: 33 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -14,83 +14,93 @@ categories:
1414
- Community
1515
---
1616

17-
The DDEV Community has regular contributor training sessions, and in July, 2023 we talked about setting up a Go development environment for DDEV. This blog summarizes [the contributor training session](https://youtu.be/IjrJw0Ay-dk). The (Min digit) syntax added below provides the minute on which each subject is covered on the recording.
17+
The DDEV Community has regular contributor training sessions, and in July, 2023 we talked about setting up a Go development environment for DDEV. This blog summarizes [the contributor training session](https://youtu.be/HHoMa1N_5S4). The (Min digit) syntax added below provides the minute on which each subject is covered on the recording.
1818

19-
## Installing Go on different Operating Systems ([Min 10:51](https://youtu.be/IjrJw0Ay-dk?t=647))
19+
<div class="video-container">
20+
<iframe width="560" height="315" src="https://www.youtube.com/embed/HHoMa1N_5S4?si=5XB2sI_E6tYELwkm" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
21+
</div>
22+
23+
## Installing Go on different Operating Systems ([Min 10:51](https://youtu.be/HHoMa1N_5S4?t=647))
2024

2125
Randy used macOS and recommended Homebrew as the tool to manage Go updates.
2226

2327
The first command recommended was
2428

25-
```
29+
```bash
2630
brew install go golangci-lint
2731
```
2832

29-
DDEV uses [make](https://www.gnu.org/software/make/) ([Min 13:32](https://youtu.be/IjrJw0Ay-dk?t=810)) to build its binary. Make is included with the macOS Command-Line Tools for Xcode and can be installed with `xcode-select --install`, but that is already required to install Homebrew, so should already be installed.
33+
DDEV uses [make](https://www.gnu.org/software/make/) ([Min 13:32](https://youtu.be/HHoMa1N_5S4?t=810)) to build its binary. Make is included with the macOS Command-Line Tools for Xcode and can be installed with `xcode-select --install`, but that is already required to install Homebrew, so should already be installed.
3034

31-
## Cloning [DDEV](https://github.com/ddev/ddev) repository ([Min 15:30](https://youtu.be/IjrJw0Ay-dk?t=932))
35+
## Cloning [DDEV](https://github.com/ddev/ddev) repository ([Min 15:30](https://youtu.be/HHoMa1N_5S4?t=932))
3236

3337
Check out the `ddev` repository with `git clone [email protected]:ddev/ddev -o upstream`. Run `make` to create a new binary. The DDEV Makefile will automatically detect your host OS and build the appropriate binary. However, one can provide a parameter to build others. As an example, `make darwin_amd64` builds the macOS AMD64 binary.
3438

35-
At ([Min 16:30](https://youtu.be/IjrJw0Ay-dk?t=982)) the Makefile located in the root of the DDEV project is lightly explained.
39+
At ([Min 16:30](https://youtu.be/HHoMa1N_5S4?t=982)) the Makefile located in the root of the DDEV project is lightly explained.
3640

3741
Randy usually symlinks the built binary version to a place inside the `$PATH`, but to run a newly compiled binary one can specify its fully qualified path. For example:
3842

39-
```
43+
```bash
4044
./.gotmp/bin/darwin_arm64/ddev --version
4145
```
4246

43-
If we want to avoid prefixing ddev with its built path instructions are included at ([Min 17:37](https://youtu.be/IjrJw0Ay-dk?t=1056)). `ddev --version` describes which binary version is currently used; it's selected by your `$PATH`.
47+
If we want to avoid prefixing ddev with its built path instructions are included at ([Min 17:37](https://youtu.be/HHoMa1N_5S4?t=1056)). `ddev --version` describes which binary version is currently used; it's selected by your `$PATH`.
4448

45-
## The role of `mkdocs` ([Min 21:22](https://youtu.be/IjrJw0Ay-dk?t=1276))
49+
## The role of `mkdocs` ([Min 21:22](https://youtu.be/HHoMa1N_5S4?t=1276))
4650

4751
`mkdocs` can be tested with `make makedocs`
4852

4953
Makedocs is used for previewing and contributing to the docs. It's named makedocs but it's not related to the make tool or compiling the binary.
5054

5155
You can preview a built version of the docs you're working with using `make mkdocs-serve`.
5256

53-
## Randy's IDE of choice is GoLand ([Min 23:50](https://youtu.be/IjrJw0Ay-dk?t=1547))
57+
## Randy's IDE of choice is GoLand ([Min 23:50](https://youtu.be/HHoMa1N_5S4?t=1547))
5458

5559
GoLand is very similar to PhpStorm and of course is made by the same JetBrains company.
5660

57-
One fantastic thing about Go is that there is only one way to format it ([Min 26:10](https://youtu.be/IjrJw0Ay-dk?t=1576)). It always uses tabs and the same indentation. It all follows the standards set by `gofmt`.
61+
One fantastic thing about Go is that there is only one way to format it ([Min 26:10](https://youtu.be/HHoMa1N_5S4?t=1576)). It always uses tabs and the same indentation. It all follows the standards set by `gofmt`.
5862

59-
## Debugging DDEV Go Code ([Min 28:17](https://youtu.be/IjrJw0Ay-dk?t=1699))
63+
## Debugging DDEV Go Code ([Min 28:17](https://youtu.be/HHoMa1N_5S4?t=1699))
6064

6165
To verify formatting and static analysis use `make golangci-lint`
6266

6367
`golangci-lint` is the tool used on DDEV CI/CD for incoming pull requests.
6468

65-
For new feature-based pull requests ([Min 31:34](https://youtu.be/IjrJw0Ay-dk?t=1892)) Randy recommends starting with an issue to explain to maintainers the context surrounding their concerns before beginning a PR.
69+
For new feature-based pull requests ([Min 31:34](https://youtu.be/HHoMa1N_5S4?t=1892)) Randy recommends starting with an issue to explain to maintainers the context surrounding their concerns before beginning a PR.
6670

67-
The [DDEV Docs development tab](https://docs.ddev.com/en/latest/developers/) ([Min 32:20](https://youtu.be/IjrJw0Ay-dk?t=1938)) includes plenty of tips and insights.
71+
The [DDEV Docs development tab](https://docs.ddev.com/en/latest/developers/) ([Min 32:20](https://youtu.be/HHoMa1N_5S4?t=1938)) includes plenty of tips and insights.
6872

69-
#### [GoLand](https://www.jetbrains.com/go/) debugging insights ([Min 33:39](https://youtu.be/IjrJw0Ay-dk?t=2014))
73+
#### [GoLand](https://www.jetbrains.com/go/) debugging insights ([Min 33:39](https://youtu.be/HHoMa1N_5S4?t=2014))
7074

7175
At this point Randy showed us a demo on how to run `ddev/cmd/debug-config-yml.go` by first running main.go and then setting the working directory to match an active ddev project.
7276

73-
#### VS Code Go debugging ([Min 37:50](https://youtu.be/IjrJw0Ay-dk?t=2268))
77+
#### VS Code Go debugging ([Min 37:50](https://youtu.be/HHoMa1N_5S4?t=2268))
7478

7579
The following extension is mentioned, [Go](https://marketplace.visualstudio.com/items?itemName=golang.Go) by the Go team at Google.
7680

77-
DDEV comes with a launch.json prebuilt for you. It includes the config that might be found in GoLand UI but for VS Code. The one item Randy usually has to change is the working directory ([Min 39:57](https://youtu.be/IjrJw0Ay-dk?t=2395)). He then showed an example on how to debug Go in VS Code.
81+
DDEV comes with a launch.json prebuilt for you. It includes the config that might be found in GoLand UI but for VS Code. The one item Randy usually has to change is the working directory ([Min 39:57](https://youtu.be/HHoMa1N_5S4?t=2395)). He then showed an example on how to debug Go in VS Code.
7882

79-
The most important GO files are in pkg/ddevapp ([Min 44:26](https://youtu.be/IjrJw0Ay-dk?t=2660)), the ones in cmd are the ones associated with a commands and the pkg Go files are functionality.
83+
The most important GO files are in pkg/ddevapp ([Min 44:26](https://youtu.be/HHoMa1N_5S4?t=2660)), the ones in cmd are the ones associated with a commands and the pkg Go files are functionality.
8084

8185
[Cobra](https://cobra.dev/) is the library used for command flags and arguments. A lot of the commands in the cmd directory are an implementation that calls upon other things.
8286

83-
At ([Min 49:43](https://youtu.be/IjrJw0Ay-dk?t=2977)) a question arose from a user's ability to get VS Code Go working:
87+
At ([Min 49:43](https://youtu.be/HHoMa1N_5S4?t=2977)) a question arose from a user's ability to get VS Code Go working:
8488

85-
```
86-
"cwd":"${workspaceRoot}/../d9simple"
89+
```json
90+
{
91+
"configurations": [
92+
{
93+
"cwd": "${workspaceRoot}/../d9simple"
94+
}
95+
]
96+
}
8797
```
8898

8999
The issue was that "d9simple" is a placeholder string that needs to point to a real DDEV directory.
90100

91-
At ([Min 50:50](https://youtu.be/IjrJw0Ay-dk?t=3048)) we can see a walkthrough of running Go tests in VS Code.
101+
At ([Min 50:50](https://youtu.be/HHoMa1N_5S4?t=3048)) we can see a walkthrough of running Go tests in VS Code.
92102

93-
devcontainer.json ([Min 58:35](https://youtu.be/IjrJw0Ay-dk?t=3507)) is a file for GitHub Codespaces.
103+
devcontainer.json ([Min 58:35](https://youtu.be/HHoMa1N_5S4?t=3507)) is a file for GitHub Codespaces.
94104

95105
## Keep in touch!
96106

src/content/blog/xdebug-debugging.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ PHP developers have long had a variety of complications using Xdebug. It's a net
1919
Here's a recording of our **Xdebug contributor Training** walking through DDEV and Xdebug.
2020

2121
<div class="video-container">
22-
<iframe width="560" height="315" src="https://www.youtube.com/embed/4MrwXTaHfnc?si=nwocfW8FjXitbtSa" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
22+
<iframe width="560" height="315" src="https://www.youtube.com/embed/IiKB8-sCiJk?si=Hs8uyjhuy0qn7cz0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
2323
</div>
2424

2525
First of all, congratulations for making step-debugging a priority. It's my opinion that step-debugging is one of the very first things to learn in any language or environment that we undertake.

0 commit comments

Comments
 (0)