markusproject / wiki

Markus Project Wiki pages

Wiki

Wiki for the current MarkUs development version

Wiki for the current MarkUs production version

For any other version go to this url:

https://github.com/MarkUsProject/Wiki/blob/VERSION/Home.md

replacing VERSION with the MarkUs version you are looking for (ex: v2.0.7).

Note that wiki documentation is only available for versions:

• v1.4.1
• v2.0.6+

For all other MarkUs versions, please refer to the next closest available version for the most up to date information.

wiki's Issues

git branch instructions - worthy of their own wiki entry?

There are no instructions for setting up the git branch (that I can find).

I've compiled them here and was unsure if they should be in their own page or merged into another page if they are of enough significance to warrant integration.

Vagrant setup instructions: gist does not work to download

Mac OSX automagically converts the vagrantfile to .txt which vagrant up will not pick up in the directory. It needs to be a file that is cloned from a repo or hand transcribed from the gist.

Is this is case for anyone else? If so, a step to $ curl [address] for the file should be added.

👍 to @oneohtrix for the file

Convert RST to Markdown

I unfortunately never really got around to doing this, but this is a tool that might be useful for those who work on it in the future: http://marksy.arc90.com/

Create wiki page describing how to do MarkUs testing

Talk about shoulda, machinist, unit and functional tests. That we don't use (try to get rid of) fixtures, etc. Should be useful for new developers.

Update recommended node version

Currently the installation documentation recommends at least node 12. We should probably recommend at least version 14 instead and we may want to recommend the latest version if possible.

Another option is to have an actual system dependencies lock file for these sort of things and an install script for system dependencies so that we can just refer to that in the installation documentation. That way the installation steps are simplified and we don't have to update the wiki to keep up with system dependency changes.

Document issues during MarkUs installation on Linux

Document the challenges encountered when installing MarkUs on Ubuntu during code sprint, which include using rvm to install a previous version of Ruby, openssl error, and cannot load such file error for svn/repos and svn/ext/core.

Create one comprehensive wiki page on contribution details

It would be helpful if there was 1 wiki page that detailed all the topics relevant contributing to Markus. It would contain the topics such as

• What git environment variables you should set up
• What tests you should run
• How to branch off and fix issues
• How to create new issues, etc...

Right now, this information is scattered around in multiple different areas.

Add a section on the life cycle of remark requests

The link to Sandbox in the navigation pane of markusproject.org leads to Demo instead

The link on the navigation pane on the right side of the markusproject.org website redirects to demo.markusproject.org instead of sandbox.markusproject.org

Avoid assigning graders to submissions from students no longer enrolled

This is a suggestion for an extension of the "Do not assign graders to groups with empty submissions". Would it be possible to add a checkbox to the effect of "Do not assign graders to groups whose students dropped the course". For instance, if a student who works individually or a group whose members all dropped the course have submitted something, then dropped the course, it may help to have a way to flag that this submission does not need to be assigned to a grader.

error `make`ing new version of subversion bindings

Using the new RVM/libruby-svn installation instructions (that uses subversion-1.8.9 instead of 1.6.17) breaks during make swig-rb:
make: *** [subversion/bindings/swig/ruby/libsvn_swig_ruby/swigutil_rb.lo] Error 1
This is on a completely fresh Ubuntu box. When I used the old version (1.6.17) it worked as expected. I think we should change the docs to revert to using that one.

can't find svn-ruby package

I'm setting up a new vagrant box and the docs say to install svn-ruby but it's not being found: E: Unable to locate package svn-ruby. Has the library been removed or renamed (to libsvn-ruby)? If so we should update the docs.