Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Update generate_output docstring #2098

Merged
merged 1 commit into from
Aug 16, 2023

Conversation

Zunawe
Copy link
Collaborator

@Zunawe Zunawe commented Aug 10, 2023

What is this fixing or adding?

The generate_output docstring has become particularly confusing now that MultiWorld objects are being encouraged to be named multiworld and per_slot_randoms is deprecated in favor of AutoWorld.random, which might now be confused with the term world.random.

Did a search for world.random in the whole codebase outside world implementations and didn't find any other documentation that looks like this.

Copy link
Collaborator

@alwaysintreble alwaysintreble left a comment

Choose a reason for hiding this comment

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

Seems like a good idea

@ThePhar ThePhar added is: documentation Improvements or additions to documentation. affects: core Issues/PRs that touch core and may need additional validation. labels Aug 16, 2023
@ThePhar ThePhar changed the title Docs: Update generate_output docstring Docs: Update generate_output docstring Aug 16, 2023
@ThePhar ThePhar merged commit be07634 into ArchipelagoMW:main Aug 16, 2023
ScipioWright added a commit to ScipioWright/Archipelago-SW that referenced this pull request Aug 26, 2023
Updating the error message since it sent us on a wild goose chase looking to figure out why randoms were causing an error, where the actual error was from accidentally putting a Location into slot_data instead of its name.

Also changing the recommendation from per_slot_randoms to self.random to mirror the change in PR ArchipelagoMW#2098 that got done last week.
@Zunawe Zunawe deleted the docstring-fix branch August 28, 2023 18:52
FlySniper pushed a commit to FlySniper/Archipelago that referenced this pull request Nov 14, 2023
Jouramie pushed a commit to Jouramie/Archipelago that referenced this pull request Feb 28, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
affects: core Issues/PRs that touch core and may need additional validation. is: documentation Improvements or additions to documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants