blob: 998070ff79a31e393201375aafa6eec1f50aac47 [file] [log] [blame] [view]
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
### How to Setup
Please follow the below steps in order to setup the project properly:
* Using GoLand with the EduTools plugin, select "+ New Project"
* Click "Yes" to create project from existing sources when prompted
* Wait for indexing to finish
* Open the "Project" tool window, and select the "Course" view
* Your project is ready
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.