update options in game logic section with anchors

and clean up TAF cookbook as well

Author: bosh

docs/cookbook/TAF_mansion_awards.md

@@ -270,48 +270,48 @@ Stepping through how we're using each setting:
 
 `show_tokens:`
 
-:   link this achievement to it's light on the playfield.
+link this achievement to it's light on the playfield.
 
-`show_when_selected: flash`
+`show_when_selected: flash`:
 
-:   Plays the show called "flash" when this achievement is selected.
-    Note that the default "flash" show is 1 sec on / 1 sec off. While
-    you can play it faster, the original Addams Family flashed the
-    lights more like .75s on / .25 off, so you'd probably want to
-    create a custom version of the "flash" show for TAF that flashed
-    them more like the original version.
+Plays the show called "flash" when this achievement is selected.
+Note that the default "flash" show is 1 sec on / 1 sec off. While
+you can play it faster, the original Addams Family flashed the
+lights more like .75s on / .25 off, so you'd probably want to
+create a custom version of the "flash" show for TAF that flashed
+them more like the original version.
 
-`show_when_completed: on`
+`show_when_completed: on`:
 
-:   Plays the show called "on" when this achievement is complete
+Plays the show called "on" when this achievement is complete
 
-`events_when_started: award_thing_multiball`
+`events_when_started: award_thing_multiball`:
 
-:   Posts an event called *award_thing_multiball* when this achievement
-    is started. We'll use this as the start event for the Thing
-    Multiball mode.
+Posts an event called *award_thing_multiball* when this achievement
+is started. We'll use this as the start event for the Thing
+Multiball mode.
 
-`enable_events: initialize_mansion, reset_mansion`
+`enable_events: initialize_mansion, reset_mansion`:
 
-:   Enables this achievement when either of the events
-    *initialize_mansion* or *reset_mansion* is posted. Prior to that,
-    this achievement will be disabled.
+Enables this achievement when either of the events
+*initialize_mansion* or *reset_mansion* is posted. Prior to that,
+this achievement will be disabled.
 
-`complete_events: award_thing_multiball`
+`complete_events: award_thing_multiball`:
 
-:   Watches for the event *award_thing_multiball*, and when it sees it,
-    it marks this achievement as complete. Notice this is the same event
-    that this achievement posts when it starts. In other words, we've
-    configured it so the achievement is complete as soon as it starts!
-    This is by design, because the rules state that once an achievement
-    is awarded, the chair can be relit immediately, and it's possible
-    to receive the next award even while the mode from the prior award
-    is still running.
+Watches for the event *award_thing_multiball*, and when it sees it,
+it marks this achievement as complete. Notice this is the same event
+that this achievement posts when it starts. In other words, we've
+configured it so the achievement is complete as soon as it starts!
+This is by design, because the rules state that once an achievement
+is awarded, the chair can be relit immediately, and it's possible
+to receive the next award even while the mode from the prior award
+is still running.
 
-`reset_events: reset_mansion`
+`reset_events: reset_mansion`:
 
-:   Watches for an event called *reset_mansion* that will reset this
-    achievement back to its initial (disabled) state.
+Watches for an event called *reset_mansion* that will reset this
+achievement back to its initial (disabled) state.
 
 This achievements configuration takes care of the following rules:
 
@@ -383,80 +383,78 @@ achievement_groups:
 
 Let's look at each of these settings:
 
-`achievements:`
+`achievements:`:
 
-:   This is just the list of the 12 achievements that make up this
-    group.
+This is just the list of the 12 achievements that make up this group.
 
-`show_tokens:`
+`show_tokens:`:
 
-:   These are the show tokens for the group itself. In this case
-    it's the yellow light on the electric chair, since this light
-    turns on and off to indicate whether the chair or swamp can be shot
-    to award the currently selected item.
+These are the show tokens for the group itself. In this case
+it's the yellow light on the electric chair, since this light
+turns on and off to indicate whether the chair or swamp can be shot
+to award the currently selected item.
 
-`auto_select: yes`
+`auto_select: yes`:
 
-:   This is used to make sure that one achievement is selected at all
-    times. If the currently selected achievement is completed, the
-    achievement group will notice that there is no currently selected
-    achievement and it will pick one from random from the remaining
-    achievements (those that are "enabled").
+This is used to make sure that one achievement is selected at all
+times. If the currently selected achievement is completed, the
+achievement group will notice that there is no currently selected
+achievement and it will pick one from random from the remaining
+achievements (those that are "enabled").
 
-`events_when_all_completed: select_tour_mansion`
+`events_when_all_completed: select_tour_mansion`:
 
-:   Posts an event called *select_tour_mansion* once all 12 achievements
-    in this group in complete. We'll use this later to light the "tour
-    mansion" award.
+Posts an event called *select_tour_mansion* once all 12 achievements
+in this group in complete. We'll use this later to light the "tour
+mansion" award.
 
-`enable_while_no_achievement_started: no`
+`enable_while_no_achievement_started: no`:
 
-:   In our case, we do not want to automatically enable the achievement
-    group when no achievement is started, because the rules for Addams
-    Family say that the player has to shoot the center ramp or right
-    inlane to light the chair (which is enabling this achievement
-    group).
+In our case, we do not want to automatically enable the achievement
+group when no achievement is started, because the rules for Addams
+Family say that the player has to shoot the center ramp or right
+inlane to light the chair (which is enabling this achievement group).
 
-`show_when_enabled: on`
+`show_when_enabled: on`:
 
-:   This plays the show called "on" when the achievement group is in
-    the enabled state. This will have the effect of turning on the
-    yellow chair light (from the `show_tokens:` section) when the
-    achievement group is enabled and the selected item can be awarded.
+This plays the show called "on" when the achievement group is in
+the enabled state. This will have the effect of turning on the
+yellow chair light (from the `show_tokens:` section) when the
+achievement group is enabled and the selected item can be awarded.
 
-`select_random_achievement_events: sw_jet`
+`select_random_achievement_events: sw_jet`:
 
-:   In Addams Family, each pop bumper hit changes the currently selected
-    mansion award. To make this happen, we added a tag called "jet" to
-    the five pop bumper switches. (That will post an event called
-    *sw_jet* any time one of these switches is hit. Then we add that
-    event name here which will cause this achievement group to change
-    the currently selected award.
+In Addams Family, each pop bumper hit changes the currently selected
+mansion award. To make this happen, we added a tag called "jet" to
+the five pop bumper switches. (That will post an event called
+*sw_jet* any time one of these switches is hit. Then we add that
+event name here which will cause this achievement group to change
+the currently selected award.
 
-`allow_selection_change_while_disabled: yes`
+`allow_selection_change_while_disabled: yes`:
 
-:   The pop bumper hits to change the current selection happens
-    regardless of whether the group is enabled (e.g. the chair is lit)
-    or not, so we use this setting to allow that selection change to
-    happen at any time.
+The pop bumper hits to change the current selection happens
+regardless of whether the group is enabled (e.g. the chair is lit)
+or not, so we use this setting to allow that selection change to
+happen at any time.
 
-`start_selected_events: balldevice_electric_chair_ball_enter, balldevice_swamp_kickout_ball_enter, award_mansion_from_bear`
+`start_selected_events: balldevice_electric_chair_ball_enter, balldevice_swamp_kickout_ball_enter, award_mansion_from_bear`:
 
-:   A shot to either the electric chair or the swamp kickout will award
-    the selected achievement.
+A shot to either the electric chair or the swamp kickout will award
+the selected achievement.
 
-`enable_events: light_chair`
+`enable_events: light_chair`:
 
-:   When an event called *light_chair* is posted, this achievement group
-    will be enabled (which will turn on the chair light and allow the
-    selected achievement to be started via the `start_selected_events:`.
+When an event called *light_chair* is posted, this achievement group
+will be enabled (which will turn on the chair light and allow the
+selected achievement to be started via the `start_selected_events:`.
 
-`disable_events: unlight_chair`
+`disable_events: unlight_chair`:
 
-:   When an event called *unlight_chair* is posted, this achievement group
-    will be disabled. The chair light will turn off, and the
-    `start_selected_events:` will not cause the current selected
-    achievement to start.
+When an event called *unlight_chair* is posted, this achievement group
+will be disabled. The chair light will turn off, and the
+`start_selected_events:` will not cause the current selected
+achievement to start.
 
 This step takes care of:
 

docs/game_logic/achievements/achievement_groups.md

@@ -56,15 +56,14 @@ For
 [conditional events](../../events/overview/conditional.md), the prefix for achievement groups is
 `device.achievement_groups.(name)`.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) as to whether this achievement group is
-    enabled.
+Boolean (true/false) as to whether this achievement group is enabled.
 
-*selected_member*
+### *selected_member*:
 
-:   The achievement in the group that is currently in the selected
-    state, or *None* if no achievement is selected.
+The achievement in the group that is currently in the selected
+state, or *None* if no achievement is selected.
 
 ## Related How To guides
 

docs/game_logic/ball_holds.md

@@ -36,13 +36,13 @@ For
 [dynamic values](../config/instructions/dynamic_values.md) and
 [conditional events](../events/overview/conditional.md), the prefix for ball holds is `device.ball_holds.(name)`.
 
-*balls_held*
+### *balls_held*:
 
-:   The number of balls this ball hold is currently holding
+The number of balls this ball hold is currently holding
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this ball hold is enabled.
+Boolean (true/false) which shows whether this ball hold is enabled.
 
 ## Related How To guides
 

docs/game_logic/combo_switches.md

@@ -110,10 +110,10 @@ For
 [conditional events](../events/overview/conditional.md), the prefix for combo switches is
 `device.combo_switches.(name)`.
 
-*state*
+### *state*:
 
-:   String which reflects what state this combo switch is in. Options
-    wil be one of the following: *inactive*, *both* or *one*.
+String which reflects what state this combo switch is in. Options
+wil be one of the following: *inactive*, *both* or *one*.
 
 ## Related How To guides
 

docs/game_logic/logic_blocks/accruals.md

@@ -71,22 +71,21 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for accruals is `device.accruals.(name)`.
 
-*value*
+### *value*:
 
-:   The state of this accrual as list. There will be one entry for every
-    element in the accrual. For instance, if your accrual has three
-    elements if will be a list of len three with index 0 for the status
-    of your first element, 1 for the seconds and 2 for the third
-    element. Elements will be 0 at the beginning and turn to 1 when
-    completed.
+The state of this accrual as list. There will be one entry for every
+element in the accrual. For instance, if your accrual has three
+elements if will be a list of len three with index 0 for the status
+of your first element, 1 for the seconds and 2 for the third
+element. Elements will be 0 at the beginning and turn to 1 when completed.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this accrual is enabled.
+Boolean (true/false) which shows whether this accrual is enabled.
 
-*completed*
+### *completed*:
 
-:   True if the block is completed. Otherwise False.
+True if the block is completed. Otherwise False.
 
 This is an example:
 

docs/game_logic/logic_blocks/counters.md

@@ -72,17 +72,17 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for counters is `device.counters.(name)`.
 
-*value*
+### *value*:
 
-:   The count of this counter.
+The count of this counter.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this counter is enabled.
+Boolean (true/false) which shows whether this counter is enabled.
 
-*completed*
+### *completed*:
 
-:   True if the block is completed. Otherwise False.
+True if the block is completed. Otherwise False.
 
 This is an example:
 

docs/game_logic/logic_blocks/index.md

@@ -12,25 +12,24 @@ achievements, and other parts of your game logic.
 
 There are four types of logic blocks in MPF:
 
-[Counter Logic Blocks](counters.md)
+## [Counter Logic Blocks](counters.md)
 
-:   Count the number of times an event happens, and when a certain
-    number is hit, a "complete" event is posted.
+Count the number of times an event happens, and when a certain
+number is hit, a "complete" event is posted.
 
-[Accrual Logic Blocks](accruals.md)
+## [Accrual Logic Blocks](accruals.md)
 
-:   Watch for several different events to occur, and once they all do
-    (no matter what order they happen in), a "complete" event is
-    posted.
+Watch for several different events to occur, and once they all do
+(no matter what order they happen in), a "complete" event is posted.
 
-[Sequence Logic Blocks](sequences.md)
+## [Sequence Logic Blocks](sequences.md)
 
-:   Watch for several different events that need to occur *in a specific
-    order*, and once they do, a "complete" event is posted.
+Watch for several different events that need to occur *in a specific
+order*, and once they do, a "complete" event is posted.
 
-[State Machine Logic Block](state_machines.md)
+## [State Machine Logic Block](state_machines.md)
 
-:   A generic state machine with arbitrary state transitions and state.
+A generic state machine with arbitrary state transitions and state.
 
 Logic blocks can be configured to store their state in player variables,
 meaning that each logic block will remember where it was from

docs/game_logic/logic_blocks/sequences.md

@@ -65,22 +65,22 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for sequences is `device.sequences.(name)`.
 
-*value*
+### *value*:
 
-:   The state of this sequence as list. There will be one entry for
-    every element in the sequence. For instance, if your sequence has
-    three elements if will be a list of len three with index 0 for the
-    status of your first element, 1 for the seconds and 2 for the third
-    element. Elements will be 0 at the beginning and turn to 1 when
-    completed.
+The state of this sequence as list. There will be one entry for
+every element in the sequence. For instance, if your sequence has
+three elements if will be a list of len three with index 0 for the
+status of your first element, 1 for the seconds and 2 for the third
+element. Elements will be 0 at the beginning and turn to 1 when
+completed.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this sequence is enabled.
+Boolean (true/false) which shows whether this sequence is enabled.
 
-*completed*
+### *completed*:
 
-:   True if the block is completed. Otherwise False.
+True if the block is completed. Otherwise False.
 
 This is an example: