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

Revise Ch 5. Running An Adventure #135

Open
3 tasks
tajmone opened this issue Dec 5, 2021 · 0 comments
Open
3 tasks

Revise Ch 5. Running An Adventure #135

tajmone opened this issue Dec 5, 2021 · 0 comments
Labels
📖 Alan Manual Issues relating to "The Alan Language Manual" ♻️ help wanted Collaborative help is needed

Comments

@tajmone
Copy link
Collaborator

tajmone commented Dec 5, 2021

NOTE — This text was take from PR #126, which was merged prematurely.


@thoni56, there are a number of things that need to be fixed or added in Ch, 5, so I'm opening a PR and start proposing changes one commit at the time (so if we don't like something we can revert the commit).

I'm also annotating in comments the various problems that need to be addressed, so feel free to add their fixes by adding your commits to this branch.

Last time we used a PR to co-edit a chapter we ended up having trouble using the reviews system. Let's see if this time we can manage to handle discussing the various fixes without getting entangled with the reviews system.

Pending Tasks

  • In §5.1, first paragraph, clarify if Start At counts as a turn, i.e. if EVENTs and SCRIPTs are executed within Start, and what turn it will be after that (turn 0 or 1?).

  • We should clarify somewhere in this chapter what makes a turn click and what doesn't. E.g. META VERBs don't advance a turn, so EVENTs and SCRIPTs aren't executed. A misunderstood command doesn't count, right? What about failed CHECKs? or attempting to use a VERB that violates the WHERE clause of the syntax? Authors needs this info to understand how turns interact with EVENTs and SCRIPTs. There's already a phrase stating:

    If the player enters an empty command, this is equivalent to forfeiting the turn.

    so maybe this info should go there.

  • Clarify THEM player-word (see The THEM Conundrum #127).

@tajmone tajmone added ♻️ help wanted Collaborative help is needed 📖 Alan Manual Issues relating to "The Alan Language Manual" labels Dec 5, 2021
@tajmone tajmone added this to the Alan Manual Improve Contents milestone Dec 5, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📖 Alan Manual Issues relating to "The Alan Language Manual" ♻️ help wanted Collaborative help is needed
Projects
None yet
Development

No branches or pull requests

1 participant