From bf6c4bad144cce6a7a6483ee1be12f37962425ae Mon Sep 17 00:00:00 2001 From: marlenezw Date: Wed, 19 Jul 2023 12:56:35 +0200 Subject: [PATCH 1/3] adding instructions for using Github codespaces to contribute to cpython. --- getting-started/index.rst | 1 + getting-started/using-codespaces.rst | 48 ++++++++++++++++++++++++++++ 2 files changed, 49 insertions(+) create mode 100644 getting-started/using-codespaces.rst diff --git a/getting-started/index.rst b/getting-started/index.rst index 420f1231c9..31563e8e5f 100644 --- a/getting-started/index.rst +++ b/getting-started/index.rst @@ -8,5 +8,6 @@ Getting Started setup-building fixing-issues git-boot-camp + using-codespaces pull-request-lifecycle getting-help diff --git a/getting-started/using-codespaces.rst b/getting-started/using-codespaces.rst new file mode 100644 index 0000000000..d43d6c5813 --- /dev/null +++ b/getting-started/using-codespaces.rst @@ -0,0 +1,48 @@ +.. _using-codespaces: +.. _codespaces: + +=================================== +Contribute Using Github Codespaces +=================================== + +.. _codespaces-whats-codespaces: + +What is Github Codespaces +------------------------- + +If you'd like to start contributing to CPython without needing to set up a local developer environment, you can use `Github Codespaces `_. +Codespaces is a cloud-based development environment offered by GitHub that allows developers to write, build, test, and debug code directly within their web browser or in Visual Studio Code (VS Code). + +To help you get started CPython contains a `devcontainer folder `_ with a json file that provides consistent and versioned codespace configurations for all users of the project. +It also contains a docker file that allows you to set up the same environment but locally in a docker container if you'd prefer to do that. + +.. _codespaces-create-a-codespace: + +Create A CPython Codespace +-------------------------- + +Here are the basic steps needed to contribute a patch using Codespaces. +You first need to navigate to the `CPython repo `_ hosted on GitHub. + +Then you will need to: + +1. Click the green :guilabel:`Code` button and choose the `codespaces` tab. +2. Press the green :guilabel:`create a new codespace on main` button. +3. A screen should appear that lets you know your codespace is being set up. (Note: Since the CPython devcontainer is provided codespaces will use the configurations it specifies.) +4. VS Code will open inside of your web browser, already linked up with your code and a terminal to the remote codespace. +5. Use the terminal with the usual git commands to create a new branch, commit and push your changes once you're ready! + +If you close your repository and come back later you can always resume your codespace by navigating to the CPython repo, selecting the codespaces tab and selecting your most recent codespaces session. + +.. _codespaces-use-locally: + +Use Codespaces Locally +----------------------- + +On the bottom left side of the codespace screen you will see a green or grey square that says :guilabel:`Codespaces`. +You can click on this for additional options. If you prefer working on a locally installed copy of VS Code you can select the option `Open in VS Code`. +You will still be working on the remote codespace instance, thus utilising the remote instance compute power. +The compute power may be a much higher spec than your local machine which can be helpful. + + +.. TODO: add docker instructions From 62edbd957e3e6e241f76bc9ec9788f256ece1dd5 Mon Sep 17 00:00:00 2001 From: Marlene Mhangami Date: Wed, 19 Jul 2023 12:56:35 +0200 Subject: [PATCH 2/3] adding instructions for using Github codespaces to contribute to cpython. --Adding codespaces instructions-- --- getting-started/index.rst | 1 + getting-started/using-codespaces.rst | 48 ++++++++++++++++++++++++++++ 2 files changed, 49 insertions(+) create mode 100644 getting-started/using-codespaces.rst diff --git a/getting-started/index.rst b/getting-started/index.rst index 420f1231c9..31563e8e5f 100644 --- a/getting-started/index.rst +++ b/getting-started/index.rst @@ -8,5 +8,6 @@ Getting Started setup-building fixing-issues git-boot-camp + using-codespaces pull-request-lifecycle getting-help diff --git a/getting-started/using-codespaces.rst b/getting-started/using-codespaces.rst new file mode 100644 index 0000000000..d43d6c5813 --- /dev/null +++ b/getting-started/using-codespaces.rst @@ -0,0 +1,48 @@ +.. _using-codespaces: +.. _codespaces: + +=================================== +Contribute Using Github Codespaces +=================================== + +.. _codespaces-whats-codespaces: + +What is Github Codespaces +------------------------- + +If you'd like to start contributing to CPython without needing to set up a local developer environment, you can use `Github Codespaces `_. +Codespaces is a cloud-based development environment offered by GitHub that allows developers to write, build, test, and debug code directly within their web browser or in Visual Studio Code (VS Code). + +To help you get started CPython contains a `devcontainer folder `_ with a json file that provides consistent and versioned codespace configurations for all users of the project. +It also contains a docker file that allows you to set up the same environment but locally in a docker container if you'd prefer to do that. + +.. _codespaces-create-a-codespace: + +Create A CPython Codespace +-------------------------- + +Here are the basic steps needed to contribute a patch using Codespaces. +You first need to navigate to the `CPython repo `_ hosted on GitHub. + +Then you will need to: + +1. Click the green :guilabel:`Code` button and choose the `codespaces` tab. +2. Press the green :guilabel:`create a new codespace on main` button. +3. A screen should appear that lets you know your codespace is being set up. (Note: Since the CPython devcontainer is provided codespaces will use the configurations it specifies.) +4. VS Code will open inside of your web browser, already linked up with your code and a terminal to the remote codespace. +5. Use the terminal with the usual git commands to create a new branch, commit and push your changes once you're ready! + +If you close your repository and come back later you can always resume your codespace by navigating to the CPython repo, selecting the codespaces tab and selecting your most recent codespaces session. + +.. _codespaces-use-locally: + +Use Codespaces Locally +----------------------- + +On the bottom left side of the codespace screen you will see a green or grey square that says :guilabel:`Codespaces`. +You can click on this for additional options. If you prefer working on a locally installed copy of VS Code you can select the option `Open in VS Code`. +You will still be working on the remote codespace instance, thus utilising the remote instance compute power. +The compute power may be a much higher spec than your local machine which can be helpful. + + +.. TODO: add docker instructions From 96aeda7a496879d47c9d6debd071eb8daa0314e8 Mon Sep 17 00:00:00 2001 From: Marlene Mhangami Date: Wed, 19 Jul 2023 13:41:18 +0200 Subject: [PATCH 3/3] adding code spaces documentation. Trying to update author email. --- getting-started/using-codespaces.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/using-codespaces.rst b/getting-started/using-codespaces.rst index d43d6c5813..ec809db95d 100644 --- a/getting-started/using-codespaces.rst +++ b/getting-started/using-codespaces.rst @@ -32,7 +32,7 @@ Then you will need to: 4. VS Code will open inside of your web browser, already linked up with your code and a terminal to the remote codespace. 5. Use the terminal with the usual git commands to create a new branch, commit and push your changes once you're ready! -If you close your repository and come back later you can always resume your codespace by navigating to the CPython repo, selecting the codespaces tab and selecting your most recent codespaces session. +If you close your repository and come back later you can always resume your codespace by navigating to the CPython repo and selecting the codespaces tab and selecting your most recent codespaces session. .. _codespaces-use-locally: