search

soffan-group-20 / teammates

This is the project website for the TEAMMATES feedback management tool for education
https://teammatesv4.appspot.com/
GNU General Public License v2.0
0 stars 0 forks source link

3.3 How good is the onboarding? #1

Open didrikmunther opened 1 year ago

didrikmunther commented 1 year ago

How easily can you build the project? Briefly describe if everything worked as documented or not:

  1. (a) Did you have to install a lot of additional tools to build the software?
  2. (b) Were those tools well documented?
  3. (c) Were other components installed automatically by the build script?
  4. (d) Did the build conclude automatically without errors?
  5. (e) How well do examples and tests run on your system(s)?
hampfh commented 1 year ago
  1. Not really, most of the tools required for this project I already had installed
  2. The tools mentioned are primarily Docker and npm which are both documented well themselves
  3. Among the build scripts all dependencies required were installed properly
  4. No not the first time
  5. After a lot some adjusting and a lot of setup the tests run well on my system
didrikmunther commented 1 year ago
  1. No, all programs were already installed on my computer. The required tools were Java, Docker, NPM, and Node.
  2. The tools are all well documented.
  3. Gradle and NPM are used for dependency management, and they install all dependencies automatically.
  4. No, there were quite a lot of errors caused by wrong Java and Node versions. You also had to run the setup scripts in a different order than the documentation specified.
  5. Tests ran perfectly, and the project as well.
Trumerik commented 1 year ago
  1. Not really, I had to update my Java to Java JDK 11 and install Node.js, Angular CLI, and Docker. These were all quick and easy to install.
  2. The tools themselves are well-documented and easy to install.
  3. There were gradle and npm scripts, as well as a Docker container, to get all necessary components automatically.
  4. No. I did have some trouble with tool versions, but this was easily fixed. However, I faced an npm error that was difficult to solve. It occurred on both Windows and Ubuntu WSL. Eventually, I ended up deleting and reinstalling the repo and all the tools, which resolved the issue.
  5. After everything was built successfully, the tests and examples ran as expected.
agenell commented 1 year ago
  1. I had to switch my Java version from JDK 19 to JDK 11 (was already installed).
  2. Yes, but they were written in a confusing order in the project documentation.
  3. Yes.
  4. No, however everything worked after some trial and error.
  5. Everything runs well once we got it working.