lemmalegalconsulting/docassemble-studentevaluations

Problem Resolution System Complaint and Letters guided form tool for Massachusetts Advocates for Children.

docassemble-studentevaluations's Issues

Combine "Special Education Coordinator" and "Special Education Director" into one question

We use both "Coordinator" and "Director" and it is unclear if we are referring to the same person

Remove the word "interview"

Replace with "letter" where it is appropriate, otherwise use "website"

User: other feedback

How helpful was our tool?

Choices are "very helpful", "somewhat helpful", "not helpful at all".

Very helpful

What best describes you?

Parent

User feedback:

hjhj

Question id: students name

Variable being sought: student.name.first

Add Autocomplete location

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/prs_complaint_interview.yml

Lines 202 to 223 in f1d0d9a

	---
	sets:
	- school.address.address
	- school.address.city
	id: school info
	question: |
	Where does ${ student } go to school?
	fields:
	- Name of school: school.name.first
	- School district name: school.district_name
	help: |
	This is often the name of the city where you live.
	- ${ student }'s classroom is: student.classroom_type
	input type: radio
	choices:
	- General education: general education
	- Special education: special education
	- 504 plan: 504 plan
	- Home school: home school
	- code: |
	school.address_fields(default_state="MA")
	---

Add two assessments that are always required to the list (for information only--not the checklist)

Home Assessment
A home assessment includes information on the student’s family history and home. They may include a home visit with the parent’s agreement.

Health Assessment
A health assessment identifies medical issues that may affect the student’s learning.

Remove the "followup" letter that is attached to initial evaluation letter

massachusetts_educational_evaluations_request.yml

User: other feedback

How helpful was our tool?

Choices are "very helpful", "somewhat helpful", "not helpful at all".

Very helpful

What best describes you?

Attorney or paralegal

User feedback:

[QUINTEN: could you please let me know if you receive this? I have feedback to send but don't want to enter it all if you won't receive it. Thank you--Diana]

We are concerned about starting a form intended to be user friendly with legalese to which they are required to state their understanding. Is it really necessary? Could we instead have a frequently asked questions or something to address concerns about data privacy, etc?

Question id: entire record request intro screen

Variable being sought: entire_record_request_intro_screen

PRS - Interview order

• Ask for parent's name then child
• Ask if enrolled in school THEN which school/school address

Add Privacy Policy Link

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/massachusetts_entire_student_record_request.yml

Lines 92 to 97 in f1d0d9a

	id: entire record request intro screen
	question: |
	Entire student record request
	subquestion: |
	This letter will help you request your child's entire student record.
	continue button field: entire_record_request_intro_screen

Email isn't re-validated if they choose it. Switch to ALDocument class

Make the final email/download screen use ALDocument and look like new CourtFormsOnline.org forms

Terms of use / privacy policy

• remove check box
• make terms of use plain language
• Add privacy to footer / about page

Don't screen out advocates -- "other" option on relationship

Remove start date from the "entire student records request"

Add contact information

Remove 'Not yet in school option' a parent will not need to make request if child not in school

https://github.com/LemmaLegalConsulting/docassemble-StudentEvaluations/blob/f1d0d9a8a02cddece96fbaf68bee69955889efaf/docassemble/StudentEvaluations/data/questions/massachusetts_educational_evaluations_basic_information.yml#L295-L300C11

Add page numbers to 3 template files in `massachusetts_educational_evaluations_request.yml`

Maybe migrate to Assembly Line framework

Consider, not urgent

Think about how to make the evaluation request letter something people could actually complete w/o magic words

Test email reminders in `massachusetts_educational_evaluations_request.yml`

Independent Eval - Needs interview order/logic review

1. evaluators.there_are_any is asked very early in the interview but the evaluator info is not asked until much later, I get its a screening question but its still odd
2. The mac_shared_intro_questionsrefer to both director and coordinator and we need to confirm if this is correct
3. Error currently on selected_evaluations['Other']

Address all inline `TODO` items or make GitHub issues

Use the school address lookup feature Docassemble now supports

How helpful was our tool?

Choices are "very helpful", "somewhat helpful", "not helpful at all".

Very helpful

What best describes you?

Developer

User feedback:

Use the school address lookup feature Docassemble now supports

https://docassemble.org/docs/fields.html#address%20autocomplete%20advanced

Question id: school information

Variable being sought: school.address.address

Phone/email: at least one is required

Embed Video

https://github.com/LemmaLegalConsulting/docassemble-StudentEvaluations/blob/6b70ce850bf0236dd92e0c3068a49587b7e071a3/docassemble/StudentEvaluations/data/questions/massachusetts_educational_evaluations_independent_evaluation.yml#L128C1-L150

Embed video: https://www.youtube.com/watch?v=0C2g6nzdG_0&list=PLLZkb-U9J6d0lfPrwFBR68TF9BTyH95b2&index=6

User: part of the form was confusing

Question ID	background info about language needs
What was confusing	Ask language question upfront.
Other information
Variable being sought	how_notified_school

Change Recipient to "special education coordinator"

Independent Eval - Error on download - `Error: NameError: name 'x' is not defined`

Future: add a way for people to upload documents

Could use what we have for Appeals Court, but that code is not 100% solid yet. Look into priority and safeguards, or add this once the feature is more mature on the AssemblyLine.

Add 'I dont know' option

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/prs_complaint_interview.yml

Lines 479 to 484 in f1d0d9a

	- label: |
	Are any of these concerns currently being addressed in the
	Bureau of Special Education Appeals (BSEA), either in a mediation or
	by a hearing?
	field: hearing_in_bsea
	datatype: yesnoradio

Should people be able to upload their own document/image of doc?

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/prs_complaint_interview.yml

Lines 84 to 93 in f1d0d9a

	if not (translated_documents.there_are_any or meetings.there_are_any):
	kickout_no_problems
	explain_one_at_a_time
	translated_documents.gather()
	if len(translated_documents):
	translated_documents_review
	# TODO: can we have people upload images of the docs?
	meetings.gather()
	if len(meetings):
	meetings_review

Independent Eval - Make hourly rate conditional

• If nothing is entered for evaluator's hourly rate then defaults to 0.0 (and shows on docx)

User: other feedback

How helpful was our tool?

Choices are "very helpful", "somewhat helpful", "not helpful at all".

Very helpful

What best describes you?

Edits to make

User feedback:

This is a test--can you please confirm you received?

Question id: primary language

Variable being sought: requestor.language

Independent Eval - Error selecting "Other" on `id: select independent evaluations`

ask a general background question about what the school knows about your language needs.

Teal Color on dropdown box

After clicking on the dropdown menu, the inside border is a teal color.

Ask if the student has an IEP

If they do not they will not have a special education contact. So then it will go to the SPED director. We should omit the SPED coordinator questions.

This is for the evaluation request letter--not the independent evaluation. IN that context students will already have an IEP.

have an explanation screen that says we will ask about meetings/docs

Notes from MAC

Request Letters and Evaluation Definitionsjl_ds.docx
Parent PRS Complaint Form Written Translations_6.17.2021 highlighted.docx

Move "Getting started" to title page

Embed video: https://www.youtube.com/watch?v=yGDtWXyRiXA&list=PLLZkb-U9J6d0lfPrwFBR68TF9BTyH95b2

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/massachusetts_educational_evaluations_request.yml

Lines 38 to 40 in f1d0d9a

	Initial Evaluation
	description: |-
	An interview to request an independent evaluation from a school.

Embed videos

for english and spanish videos

Make this flexible to let someone list multiple evaluations

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/prs_complaint_interview.yml

Lines 272 to 302 in 9124749

	# TODO: make this flexible to let someone list multiple evaluations
	- The school: translated_documents[i].translation_level
	input type: radio
	choices:
	- Did not translate the document at all: no_translation
	- Only translated part of the document: partial_translation
	- Attempted to translate the document, but I could not understand the translation: poor_translation
	- What kind of evaluation was it?: translated_documents[i].evaluation_type
	show if:
	variable: translated_documents[i].name
	is: school_evaluation
	- Describe the document and what happened (optional): translated_documents[i].description
	datatype: area
	required: False
	help: |
	Use your own words. For example, one parent might say: "I asked the
	school to send me a copy
	of my child’s IEP in Spanish at least two days before the team meeting,
	but they told me that they would not be able to get a copy in Spanish
	before then."
	---
	variable name: evaluation_options
	data:
	school_evaluation: School Evaluation
	progress_reports: Special Education Progress Reports/Grade Reports
	ieps: Individualized Education Programs (IEPs)
	evaluation_consent: Evaluation Consent Forms
	team_meeting: Team Meeting Invitations
	discipline_notices: Notice of School Discipline Hearings and/or Discipline Hearing Decisions
	letter_or_email: Letter or email
	other: Other

Sample for PRS complaint

REDACTED.PRS Intake_4.2.2021 FINAL.docx

User: Bug report

Question ID	requestor right to send
Steps to reproduce	test
Expected behavior	test
What happened instead	test
Other information
Variable being sought	requestor.right_to_send

Language section

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/massachusetts_educational_evaluations_basic_information.yml

Lines 197 to 210 in f1d0d9a

	What language do you speak best?
	fields:
	- Language: requestor.language
	choices:
	- English: English
	- Spanish: Spanish
	- Arabic: Arabic
	- Cantonese: Cantonese
	- Cape Verdean: Cape Verdean Creole
	- French: French
	- Haitian Creole: Haitian Creole
	- Mandarin: Mandarin
	- Portuguese: Portuguese
	- Other: Other

From notes: "Do we need this? Won’t we know the preferred language based on the language they have selected to complete the form?; and
2) if there is a reason we do need this, I think it is best to include only the languages available (Spanish, Portuguese, Haitian Creole, and Simplified Chinese)"

No red asterisk, should there be language saying one of the following is required?

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/massachusetts_educational_evaluations_basic_information.yml

Lines 251 to 262 in 9124749

	id: requestor phone number and email
	question: |
	What is your preferred phone number and email?
	fields:
	- Phone Number: requestor.phone_number
	required: False
	- Email: requestor.email
	datatype: email
	required: False
	validation code: |
	if not(requestor.phone_number) and not(requestor.email):
	validation_error("You need to provide at least one contact method.",field="requestor.phone_number")

Use pronoun list from courtformsonline.org

User: other feedback

How helpful was our tool?

Choices are "very helpful", "somewhat helpful", "not helpful at all".

Very helpful

What best describes you?

Parent

User feedback:

This is a test-can you confirm it went through Quinten?

Question id: prs_intro

Variable being sought: prs_intro

Amend template to adjust for new checkbox options (link principal email here)

Updated language in commit: "- "I want a copy of my letter...": done

datatype: checkboxes

choices:

- Emailed to me

- Emailed directly to the school principal and me

- Download as a Word document so that I can make edits and print it"

edited option 2 and added option 3 per Diana. Need to adjust template and link utilize principal email question.

docassemble-StudentEvaluations/docassemble/StudentEvaluations/data/questions/massachusetts_entire_student_record_request.yml

Lines 106 to 113 in f1d0d9a

	#id: entire record request letter screen
	#question: |
	# Here is your letter
	#subquestion: |
	# 1. Download and print the letter below.
	# 1. Keep one copy for your own records.
	# 1. Second a copy to the school district.
	#

Final download screen should offer Word format

Also the email should be in Word format