You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by lo...@apache.org on 2020/11/17 23:56:43 UTC

[beam] branch master updated: [BEAM-9782] Update README for instructions on updating katas (#13329)

This is an automated email from the ASF dual-hosted git repository.

lostluck pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/beam.git


The following commit(s) were added to refs/heads/master by this push:
     new 1653a97  [BEAM-9782] Update README for instructions on updating katas (#13329)
1653a97 is described below

commit 1653a977358d4b4933f52d2a4f27d5854f058483
Author: Damon Douglas <da...@users.noreply.github.com>
AuthorDate: Tue Nov 17 15:55:59 2020 -0800

    [BEAM-9782] Update README for instructions on updating katas (#13329)
---
 learning/katas/go/README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/learning/katas/go/README.md b/learning/katas/go/README.md
index 1ec504b..998070f 100644
--- a/learning/katas/go/README.md
+++ b/learning/katas/go/README.md
@@ -27,3 +27,32 @@ Please follow the below steps in order to setup the project properly:
 
 For further instructions on how the GoLand Education works, you can refer
 [here](https://www.jetbrains.com/help/education/educator-start-guide.html?section=Go).
+
+### How to add a new course content
+Since the Stepik course content follows specific rules, it is recommended to create content using the EduTools plugin.
+Please follow the below steps in order to add new course content:
+* Open IntelliJ/GoLand at the learning/katas/go directory and not root of the beam repository.
+* Change the Project dropdown to Course.
+* Right click where new content is to be created and select from the contextual menu
+New lesson, section, or task, where appropriate.
+* When the EduTools plugin creates new content, it will automatically create folders and files.  It is important to
+note that it will not add the ASF license and should be done manually.
+* When creating a new task, the EduTools plugin will create a go.mod in the folder.  It's important to delete this
+as well as change the main folder it creates to cmd.  Please see other tasks in the Go SDK katas for examples
+on the standard structure used throughout the course.
+* It's also important to note that when updating content, the EduTools plugin will update files and also remove
+the ASF license information.  When in doubt, the gradle rat task, at the root of the beam repository, can
+uncover any files with missing licenses.
+
+### Updating Stepik
+To update a Stepik course, one must be assigned as an instructor.
+* Open IntelliJ/GoLand at the learning/katas/go directory and not root of the beam repository.
+* Change the Project dropdown to Course.
+* Right click Beam Katas - Go (Course Creation) and find Course Creator in the context menu.
+* Click "Update course on Stepik"
+* The EduTools plugin will update and/or create `*-remote-info.yaml` files.  Commit any
+of these changed or new files to the beam repository.
+
+### Tracking the Go SDK Code Katas project
+
+[BEAM-9676](https://issues.apache.org/jira/browse/BEAM-9676) tracks the Go SDK Code Katas project.