move api reference index pages to index routes to improve nav structure generation

Author: bosh

docs/code/api_reference/api_reference_config_players.md

@@ -0,0 +1,17 @@
+# Config Players
+
+Config players are available as machine attributes in the form of their player name plus \_player, for example, `self.machine.light_player` or `self.machine.score_player`.
+
+* [blocking_player](blocking_player.md)
+* [coil_player](coil_player.md)
+* [event_player](event_player.md)
+* [flasher_player](flasher_player.md)
+* [hardware_sound_player](hardware_sound_player.md)
+* [light_player](light_player.md)
+* [queue_event_player](queue_event_player.md)
+* [queue_relay_player](queue_relay_player.md)
+* [random_event_player](random_event_player.md)
+* [score_queue_player](score_queue_player.md)
+* [segment_display_player](segment_display_player.md)
+* [show_player](show_player.md)
+* [variable_player](variable_player.md)

docs/code/api_reference/api_reference_device.md

@@ -1,4 +1,4 @@
-# Core Components
+# Core Components API Reference Index
 
 Core MPF machine components, accessible to programmers at `self.machine.*name*`. For example, the ball controller is at `self.machine.ball_controller`, the event manager is `self.machine.events`, etc.
 

docs/code/api_reference/api_reference_hardware_platforms.md

@@ -0,0 +1,62 @@
+# Devices API Reference Index
+
+Instances of MPF devices, available at `self.machine.*device_collection*.*device_name*`. For example, a flipper device called “right_flipper” is at `self.machine.flippers.right_flipper`, and a multiball called “awesome” is accessible at `self.machine.multiballs.awesome`.
+
+Note that device collections are accessible as attributes and items, so the right flipper mentioned above is also available to programmers at `self.machine.flippers['right_flipper']`.
+
+Note:
+
+“Devices” in MPF are more than physical hardware devices. Many of the “game logic” components listed in the user documentation (achievements, ball holds, extra balls, etc.) are implemented as “devices” in MPF code. (So you can think of devices as being either physical or logical.)
+
+Here's a list of all the device types in MPF, linked to their API references.
+
+* [accelerometers](accelerometers.md)
+* [accruals](accruals.md)
+* [achievement_groups](achievement_groups.md)
+* [achievements](achievements.md)
+* [autofires](autofires.md)
+* [ball_devices](ball_devices.md)
+* [ball_holds](ball_holds.md)
+* [ball_routings](ball_routings.md)
+* [ball_saves](ball_saves.md)
+* [coils](coils.md)
+* [combo_switches](combo_switches.md)
+* [counters](counters.md)
+* [digital_outputs](digital_outputs.md)
+* [diverters](diverters.md)
+* [dmds](dmds.md)
+* [drop_target_banks](drop_target_banks.md)
+* [drop_targets](drop_targets.md)
+* [dual_wound_coils](dual_wound_coils.md)
+* [extra_ball_groups](extra_ball_groups.md)
+* [extra_balls](extra_balls.md)
+* [flippers](flippers.md)
+* [hardware_sound_systems](hardware_sound_systems.md)
+* [kickbacks](kickbacks.md)
+* [light_rings](light_rings.md)
+* [light_stripes](light_stripes.md)
+* [lights](lights.md)
+* [magnets](magnets.md)
+* [motors](motors.md)
+* [multiball_locks](multiball_locks.md)
+* [multiballs](multiballs.md)
+* [playfield_transfers](playfield_transfers.md)
+* [playfields](playfields.md)
+* [psus](psus.md)
+* [rgb_dmds](rgb_dmds.md)
+* [score_queues](score_queues.md)
+* [score_reel_groups](score_reel_groups.md)
+* [score_reels](score_reels.md)
+* [segment_displays](segment_displays.md)
+* [sequence_shots](sequence_shots.md)
+* [sequences](sequences.md)
+* [servos](servos.md)
+* [shot_groups](shot_groups.md)
+* [shot_profiles](shot_profiles.md)
+* [shots](shots.md)
+* [show_queues](show_queues.md)
+* [state_machines](state_machines.md)
+* [steppers](steppers.md)
+* [switches](switches.md)
+* [timed_switches](timed_switches.md)
+* [timers](timers.md)

docs/code/api_reference/api_reference_misc_components.md

@@ -0,0 +1,34 @@
+# Hardware Platforms
+
+Hardware platforms are stored in a machine hardware_platforms dictionary, for example, `self.machine.hardware_platforms['fast']` or `self.machine.hardware_platforms['p_roc']`.
+
+* [drivers](drivers.md)
+* [fadecandy](fadecandy.md)
+* [fast](fast.md)
+* [i2c_servo_controller](i2c_servo_controller.md)
+* [light_segment_displays](light_segment_displays.md)
+* [lisy](lisy.md)
+* [mma8451](mma8451.md)
+* [mypinballs](mypinballs.md)
+* [openpixel](openpixel.md)
+* [opp](opp.md)
+* [osc](osc.md)
+* [p3_roc](p3_roc.md)
+* [p_roc](p_roc.md)
+* [pin2dmd](pin2dmd.md)
+* [pololu_maestro](pololu_maestro.md)
+* [pololu_tic](pololu_tic.md)
+* [rpi](rpi.md)
+* [rpi_dmd](rpi_dmd.md)
+* [smart_virtual](smart_virtual.md)
+* [smartmatrix](smartmatrix.md)
+* [smbus2](smbus2.md)
+* [snux](snux.md)
+* [spi_bit_bang](spi_bit_bang.md)
+* [spike](spike.md)
+* [step_stick](step_stick.md)
+* [system11](system11.md)
+* [trinamics_steprocker](trinamics_steprocker.md)
+* [virtual](virtual.md)
+* [virtual_pinball](virtual_pinball.md)
+* [visual_pinball_evolution](visual_pinball_evolution.md)

docs/code/api_reference/api_reference_modes.md

@@ -1,17 +1,17 @@
-# API Reference
+# API Reference Index
 
 MPF's API reference is broken into several categories. All of it is presented in the way that the modules and classes are actually used in MPF.
 
 * [Core Components](core/index.md): MPF core components.
 
-* [Devices](api_reference_device.md): MPF devices, including physical devices like flippers, ball devices, switches, lights, etc. as well as logical devices like ball saves, extra balls, multiballs, etc.
+* [Devices](devices/index.md): MPF devices, including physical devices like flippers, ball devices, switches, lights, etc. as well as logical devices like ball saves, extra balls, multiballs, etc.
 
-* [Modes](api_reference_modes.md): Built-in modes, such as game, attract, tilt, credits, etc.
+* [Modes](modes/index.md): Built-in modes, such as game, attract, tilt, credits, etc.
 
-* [Platforms](api_reference_hardware_platforms.md): Hardware platforms interfacess for all supported hardware.
+* [Platforms](hardware_platforms/index.md): Hardware platforms interfacess for all supported hardware.
 
-* [Config Players](api_reference_config_players.md): Modules responsible for all config players (show_player, light_player, score_player, etc.)
+* [Config Players](config_players/index.md): Modules responsible for all config players (show_player, light_player, score_player, etc.)
 
-* [Tests](api_reference_testing_class_api.md): All unit test base classes for writing tests for MPF and your own game.
+* [Tests](testing_class_api/index.md): All unit test base classes for writing tests for MPF and your own game.
 
-* [Miscellaneous Components](api_reference_misc_components.md): Things that don't fit into other categories, including utility functions, the base classes for modes, players, timers, and other utility functions.
+* [Miscellaneous Components](misc_components/index.md): Things that don't fit into other categories, including utility functions, the base classes for modes, players, timers, and other utility functions.