Skip to content

Enhance instructions (Elena suggestions)#32

Open
joel-becker wants to merge 4 commits into
mainfrom
enhance/instructions
Open

Enhance instructions (Elena suggestions)#32
joel-becker wants to merge 4 commits into
mainfrom
enhance/instructions

Conversation

@joel-becker

Copy link
Copy Markdown
Contributor

No description provided.

@joel-becker joel-becker requested a review from hibukki October 24, 2024 18:00
Comment thread src/human_setup.py Outdated
score_log = "score.py log"
setup = "human_setup.py"
submit = "submit.py"
submit = "submit.py ''"

@hibukki hibukki Oct 28, 2024

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My intuition is to add a default value for submit.py, such as maybe:
def main(submission: str = ""):
or
@click.argument("SUBMISSION", type=str, default="")
rather than sending the default value here

Also I suspect this change you made wouldn't allow the user to actually submit something

I didn't test either theory

I am not actually pushing back, feel free to ignore

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

did you test if this works, still trying to submit something?

my intuition is "I wish we had tests", but also "if/when we work together I expect we'll write tests as we go"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not tested, agree I really should!

Re: design of this, I'd be happy with anything that allowed user to simply enter submit in terminal.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. This is not the right place to make this change
  2. We should not let the user "simply enter submit" without confirming that they want to submit the empty string (e.g. using click.prompt). Some tasks require a non-empty submission (though there have been talks about changing that).

Comment thread src/human_setup.py Outdated
async def introduction(run_info: dict):
commands = {
HelperCommand.clock.name: "Start and pause the timer, or see elapsed time.",
HelperCommand.clock.name: "Start and pause the timer, or see elapsed time. If you reload or otherwise close your terminal, you will need to run this command again.",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My intuition is to print exactly how to run the command, so the user can later copy it

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This would end up being very repetitive, since it should literally be just the command name in each case.

@sjawhar sjawhar Oct 29, 2024

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure this new sentence is correct. The clock isn't automatically stopped or anything if you "reload or otherwise close your terminal", so you don't need to run clock again. I don't understand what this sentence is referring to.

Comment thread src/human_setup.py Outdated
score_log = "score.py log"
setup = "human_setup.py"
submit = "submit.py"
submit = "submit.py ''"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. This is not the right place to make this change
  2. We should not let the user "simply enter submit" without confirming that they want to submit the empty string (e.g. using click.prompt). Some tasks require a non-empty submission (though there have been talks about changing that).

Comment thread src/human_setup.py Outdated
async def introduction(run_info: dict):
commands = {
HelperCommand.clock.name: "Start and pause the timer, or see elapsed time.",
HelperCommand.clock.name: "Start and pause the timer, or see elapsed time. If you reload or otherwise close your terminal, you will need to run this command again.",

@sjawhar sjawhar Oct 29, 2024

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure this new sentence is correct. The clock isn't automatically stopped or anything if you "reload or otherwise close your terminal", so you don't need to run clock again. I don't understand what this sentence is referring to.

Comment thread src/submit.py Outdated

click.confirm(
f"Do you definitely want to end the task and submit '{submission}'?",
f"Do you definitely want to end the task and submit '{submission}'? (You will lose access to the task environment.)",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this can be formatted better:

click.echo("You are about to end the task and submit '{submission}'")
click.echo("Your work will be scored, and then you will be disconnected from the task environment")
click.confirm("Are you sure you want to proceed?", abort=True)

@mruwnik

mruwnik commented Jan 8, 2025

Copy link
Copy Markdown
Contributor

I went and implemented these comments

@joel-becker joel-becker requested a review from hibukki January 8, 2025 19:24
@mruwnik mruwnik requested a review from sjawhar January 13, 2025 16:43
@mruwnik

mruwnik commented Jan 15, 2025

Copy link
Copy Markdown
Contributor

ping @sjawhar @hibukki

@sjawhar

sjawhar commented Jan 18, 2025

Copy link
Copy Markdown
Contributor

Tests are failing. Also, please don't ping, instead request re-review.

@sjawhar sjawhar removed the request for review from hibukki January 18, 2025 23:12
Comment thread src/human_setup.py
async def introduction(run_info: dict) -> tuple[str, str, str]:
commands = {
HelperCommand.clock.name: "Start and pause the timer, or see elapsed time.",
HelperCommand.clock.name: "Start and pause the timer, or see elapsed time. This must be run explicitly - reloading or otherwise closing your terminal will not change the clock status.",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand what the second sentence means.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants