diff --git a/docs/Dockerfile b/docs/Dockerfile
index b5110e902b..917b2ad416 100644
--- a/docs/Dockerfile
+++ b/docs/Dockerfile
@@ -7,7 +7,7 @@ RUN svn checkout https://github.com/docker/machine/trunk/docs /docs/content/mach
 RUN svn checkout https://github.com/docker/distribution/trunk/docs /docs/content/registry
 RUN svn checkout https://github.com/kitematic/kitematic/trunk/docs /docs/content/kitematic
 RUN svn checkout https://github.com/docker/tutorials/trunk/docs /docs/content/tutorials
-RUN svn checkout https://github.com/docker/opensource/trunk/docs /docs/content
+RUN svn checkout https://github.com/docker/opensource/trunk/docs /docs/content/opensource
 
 ENV PROJECT=swarm
 # to get the git info for this repo
diff --git a/docs/api/swarm-api.md b/docs/api/swarm-api.md
index cc23ee4773..4c54e5908e 100644
--- a/docs/api/swarm-api.md
+++ b/docs/api/swarm-api.md
@@ -3,6 +3,7 @@
 title = "Docker Swarm API"
 description = "Swarm API"
 keywords = ["docker, swarm, clustering,  api"]
+aliases = ["/swarm/api/"]
 [menu.main]
 parent="smn_swarm_ref"
 +++
diff --git a/docs/scheduler/index.md b/docs/scheduler/index.md
new file mode 100644
index 0000000000..3a43ce7c28
--- /dev/null
+++ b/docs/scheduler/index.md
@@ -0,0 +1,16 @@
+<!--[metadata]>
++++
+title = "Docker Swarm Scheduling"
+description = "Swarm: a Docker-native clustering system"
+keywords = ["docker, swarm, clustering, scheduling"]
+[menu.main]
+parent="smn_workw_swarm"
++++
+<![end-metadata]-->
+
+## Advanced Scheduling
+
+To learn more about advanced scheduling, see the
+[strategies](strategy.md) and [filters](filter.md)
+documents.
+