Questionnaires may be unsubmittable and fail to show content

[jsorva]

In some circumstances, questionnaires do not show up correctly in A+ and are impossible for users to submit.

I’m not sure about the exact set of circumstances required for this to happen, but one example is shown below. The following RST generates a form that shows up only partially in A+, as shown in the image further below.

Luku 1.1: Kurssin esittely
==========================

.. questionnaire::
  :course-feedback:
  :no-override:

  Otsikko
  -------

  .. agree-group::

    Mielipidekysymys
    ................

    .. agree-item:: "Oletko samaa mieltä?"

  .. pick-one::

    Tämä osio ei tule näkyviin, jos "Mielipidekysymys" on otsikko.

    a. Eka
    b. Toka
    c. Kolmas

This generates the following form. Note that only the first question shows up, and there is no submit button at the end. If there had been more questions below "Mielipidekysymys", they would not have shown up, either.

—

Assorted notes:

Removing the ................ under Mielipidekysymys turns that text into a regular paragraph, which for some reason makes the problem go away (i.e., the whole form does get displayed and is submittable; however, the heading is no longer a heading).

Even so, it is not always invalid to have such headings in a questionnaire. In fact, I’ve been using them for years with no problems. In December 2022, I ran into this issue when preparing O1’s 2022 feedback questionnaire. In that questionnaire, there are multiple headings at different levels, which works fine... except that for some reason it’s not possible to turn "Kerro, missä määrin olet samaa mieltä seuraavien väitteiden kanssa" or "Muita kommentteja käytännön järjestelyistä tai muista edellisten kysymysten aiheista" into section headings or everything will fall apart. Those two texts are now regular paragraphs, so the form does work. (Those same texts have been section headings in earlier years, but this no longer works in Fall 2022, presumably due to changes in Sphinx output.)

My impression is that this could have something to do with the agree-group directive, and perhaps something to do with the fact that an agree-group directly follows a section heading, but I’m not sure.

[markkuriekkinen]

Based on your description, the issue seems to affect both MOOC-Jutut (O1 chapter feedback) and MOOC-Grader (normal questionnaires like the O1 final course feedback). Both services render questionnaire forms in their own code.

Jutut fetches assignment metadata from the A+ API. I think the metadata stored in A+ is based on the assignment YAML configuration generated in the RST course build. Jutut renders questionnaire forms based on the assignment data.

Grader renders questionnaires based on the assignment YAML configuration generated in the RST course build.