Adapt game dev guide

docs/integrating/README.md

@@ -1,4 +1,3 @@
-
 # Game developer guide
 
 This chapter describes how to distribute software that can be installed
@@ -11,3 +10,16 @@ for creators willing to go the extra mile when integrating with it.
 *Note: even though the word 'game' is used throughout this guide, it applies
 equally to other kinds of software. Games just happen to be the most popular
 kind of software installed with the app!*
+
+
+```{toctree}
+quickstart
+manifest/validating-your-manifest
+updates
+manifest
+manifest-actions
+prereqs/README
+api/README
+compatibility-policy
+troubleshooting-guide
+```

docs/integrating/platforms/linux.md

@@ -205,4 +205,3 @@ _Special thanks to Ethan Lee for proofreading this page and contributing advice.
 See the Acknowledgements section of this book for a full list of contributors._
 
 [^1]: If they can't, get a better publisher.
-

docs/integrating/platforms/macos.md

@@ -10,7 +10,7 @@ If you need an [app manifest](/integrating/manifest.md), put your .app and the m
 
 > If you really _really_ want to do something else, read the [Compatibility policy](/integrating/compatibility-policy.md) page.
 
-### ...but I don't have an app bundle
+## ...but I don't have an app bundle
 
 App bundles are directories with a standardized structure and some metadata in an `Info.plist` file.
 
@@ -38,4 +38,3 @@ We've taken several measures to ensure this works properly:
 For players that are **not **using the itch.io app, you might get reports of your app being "Damaged and can't be opened" and that it should "be moved to the trash".
 
 Player who do use the itch.io app do not encounter these issues, so you may want to encourage them to use it.
-

docs/integrating/platforms/web.md

@@ -14,19 +14,18 @@ Like the website, it will look for an `index.html` file \(or a top-level `.html`
 
 You can use `Shift+F12` to open the developer toosl, see [Troubleshooting](/integrating/troubleshooting-guide.md) for more details.
 
-### Fullscreen support
+## Fullscreen support
 
 HTML5 games launched with the app can be switched to fullscreen and their window can be resized, so make sure your CSS handles that properly.
 
-### Java applets
+## Java applets
 
 Java applets are not supported by the itch.io app.
 
-### Flash games
+## Flash games
 
 Flash games are not supported by the itch.io app.
 
-### Legacy Unity plug-in games
+## Legacy Unity plug-in games
 
 Legacy Unity plug-in games are not supported by the itch.io app. Use the **WebGL export** option instead.
-

docs/integrating/platforms/windows.md

@@ -29,4 +29,3 @@ However, you'll also have to figure out exactly what libraries you need to ship.
 Tools like [Dependency Walker](http://www.dependencywalker.com/) or [Process Monitor](https://docs.microsoft.com/en-us/sysinternals/downloads/procmon) can help.[^1]
 
 [^1]: In fact, anything from [Sysinternals](https://docs.microsoft.com/en-us/sysinternals/downloads/process-utilities) is heartily recommended. If you're not using them, you should be. Nevermind what for - download first, justify second.
-

docs/integrating/prereqs/README.md

@@ -1,5 +1,14 @@
 # Prerequisites
 
+```{toctree}
+:hidden:
+
+prereqs/vc
+prereqs/dotnet
+prereqs/xna
+prereqs/dx
+```
+
 Since we encourage developers to ship [portable builds](../platforms/windows.md), the app supports installing frameworks or libraries your game might depend on.
 
 Here's how it looks for users:

docs/integrating/quickstart.md

@@ -1,5 +1,14 @@
 # Game developer quick start
 
+```{toctree}
+:hidden:
+
+platforms/windows
+platforms/macos
+platforms/linux
+platforms/web
+```
+
 Chances are, your software already works with [the itch.io app](https://itch.io/app).
 
 But **keep reading!** This page also contains best practices.