playframework · mkurz · Apr 19, 2022 · Apr 19, 2022 · mkurz · Apr 19, 2022
diff --git a/documentation/README.md b/documentation/README.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Build documentation
 
 This is the README for the Play documentation project.  The documentation project does not build with the rest of the Play projects, and uses its own sbt setup instead.  Please refer to the [main README file](../README.md) for how to build Play in general and how to [contribute](../CONTRIBUTING.md).

diff --git a/documentation/build.sbt b/documentation/build.sbt
@@ -9,7 +9,9 @@ import playbuild.JavaVersion
 import playbuild.CrossJava
 
 import de.heikoseeberger.sbtheader.FileType
+import de.heikoseeberger.sbtheader.CommentCreator
 import de.heikoseeberger.sbtheader.CommentStyle
+import de.heikoseeberger.sbtheader.HeaderPlugin.autoImport.HeaderPattern.commentBetween
 
 val DocsApplication = config("docs").hide
 
@@ -82,8 +84,14 @@ lazy val main = Project("Play-Documentation", file("."))
     headerLicense := Some(HeaderLicense.Custom("Copyright (C) Lightbend Inc. <https://www.lightbend.com>")),
     headerMappings ++= Map(
       FileType.xml  -> CommentStyle.xmlStyleBlockComment,
-      FileType.conf -> CommentStyle.hashLineComment
+      FileType.conf -> CommentStyle.hashLineComment,
+      FileType("md") -> CommentStyle(new CommentCreator() {
+        override def apply(text: String, existingText: Option[String]): String = {
+          s"<!--- $text -->"
+        }
+      }, commentBetween("<!---", "*", "-->"))
     ),
+    Test / headerSources ++= (baseDirectory.value ** "*.md").get,
     Test / javafmt / sourceDirectories ++= (Test / unmanagedSourceDirectories).value,
     Test / javafmt / sourceDirectories ++= (Test / unmanagedResourceDirectories).value,
     // No need to show eviction warnings for Play documentation.

diff --git a/documentation/manual/Home.md b/documentation/manual/Home.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play %PLAY_VERSION% documentation
 
 > Play is a high-productivity Java and Scala web application framework that integrates the components and APIs you need for modern web application development. 

diff --git a/documentation/manual/LatestRelease.md b/documentation/manual/LatestRelease.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Latest release
 
 Learn more about the latest Play release. You can download Play releases [here](https://www.playframework.com/download).

diff --git a/documentation/manual/ModuleDirectory.md b/documentation/manual/ModuleDirectory.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play modules
 
 Play uses public modules to augment built-in functionality.  

diff --git a/documentation/manual/about/Philosophy.md b/documentation/manual/about/Philosophy.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Introducing Play 2
 
 Since 2007, we have been working on making Java web application development easier. Play started as an internal project at Zenexity (now [Zengularity](https://zengularity.com/en)) and was heavily influenced by our way of doing web projects: focusing on developer productivity, respecting web architecture, and using a fresh approach to packaging conventions from the start — breaking so-called JEE best practices where it made sense.

diff --git a/documentation/manual/gettingStarted/Anatomy.md b/documentation/manual/gettingStarted/Anatomy.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Anatomy of a Play application
 
 ## The Play application layout

diff --git a/documentation/manual/gettingStarted/IDE.md b/documentation/manual/gettingStarted/IDE.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Setting up your preferred IDE
 
 Working with Play is easy. You don’t even need a sophisticated IDE, because Play compiles and refreshes the modifications you make to your source files automatically, so you can easily work using a simple text editor.

diff --git a/documentation/manual/gettingStarted/Installing.md b/documentation/manual/gettingStarted/Installing.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Installing Play
 
 This page shows how to download, install and run a Play application.  There's a built in tutorial that shows you around, so running this Play application will show you how Play itself works!

diff --git a/documentation/manual/gettingStarted/LearningExamples.md b/documentation/manual/gettingStarted/LearningExamples.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Learning from Play Examples
 
 [Lightbend Tech Hub](https://developer.lightbend.com/start/?group=play) offers downloadable Play examples for Java and Scala. Play has many features, so rather than pack them all into one project, we've organized many examples that each showcase a Play feature or demonstrate a common use case. The zip files include everything you need to build and run the examples, including a distribution of the sbt and Gradle. Refer to the `README.md` file in the top-level project directory to learn more about the example.

diff --git a/documentation/manual/gettingStarted/NewApplication.md b/documentation/manual/gettingStarted/NewApplication.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Creating a New Application
 
 Play expects a specific project structure. If you already have [sbt installed](https://www.scala-sbt.org/1.x/docs/Setup.html), you can use a [giter8](http://www.foundweekends.org/giter8/) template, similar to a Maven archetype, to create a new Play project. This gives you the advantage of setting up your project folders, build structure, and development environment — all with one command.

diff --git a/documentation/manual/hacking/BuildingFromSource.md b/documentation/manual/hacking/BuildingFromSource.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Building Play from source
 
 If you want to use some unreleased changes for Play, or you want to contribute to the development of Play yourself, you'll need to compile Play from the source code. You’ll need a [Git client](https://git-scm.com/) to fetch the source.

diff --git a/documentation/manual/hacking/Documentation.md b/documentation/manual/hacking/Documentation.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Guidelines for writing Play documentation
 
 The Play documentation is written in Markdown format, with code samples extracted from compiled, run and tested source files.

diff --git a/documentation/manual/hacking/Issues.md b/documentation/manual/hacking/Issues.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Issues tracker
 
 We use GitHub as our issue tracker, at:

diff --git a/documentation/manual/hacking/Repositories.md b/documentation/manual/hacking/Repositories.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Artifact repositories
 
 ## Maven Central

diff --git a/documentation/manual/hacking/ThirdPartyTools.md b/documentation/manual/hacking/ThirdPartyTools.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # 3rd Party Tools
 
 A big THANK YOU! to these sponsors for their support of open source projects.

diff --git a/documentation/manual/hacking/Translations.md b/documentation/manual/hacking/Translations.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Translating the Play Documentation
 
 Play 2.3+ provides infrastructure to aid documentation translators in translating the Play documentation and keeping it up to date.

diff --git a/documentation/manual/hacking/WorkingWithGit.md b/documentation/manual/hacking/WorkingWithGit.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Working with Git
 
 This guide is designed to help new contributors get started with Play.  Some things mentioned here are conventions that we think are good and make contributing to Play easier, but they are certainly not prescriptive, you should use what works best for you.

diff --git a/documentation/manual/releases/Releases.md b/documentation/manual/releases/Releases.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # About Play releases
 
 Visit the [changelog page](https://www.playframework.com/changelog) to get started with the latest Play releases. This page lists all past Play releases starting from 2.x.

diff --git a/documentation/manual/releases/release21/Highlights21.md b/documentation/manual/releases/release21/Highlights21.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.1?
 
 ## Migration to Scala 2.10 

diff --git a/documentation/manual/releases/release21/Migration21.md b/documentation/manual/releases/release21/Migration21.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play 2.1 migration guide
 
 This is a guide for migrating from Play 2.0 to Play 2.1.

diff --git a/documentation/manual/releases/release22/Highlights22.md b/documentation/manual/releases/release22/Highlights22.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.2
 
 ## New results structure for Java and Scala

diff --git a/documentation/manual/releases/release22/Migration22.md b/documentation/manual/releases/release22/Migration22.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play 2.2 Migration Guide
 
 This is a guide for migrating from Play 2.1 to Play 2.2. If you need to migrate from an earlier version of Play then you must first follow the [[Play 2.1 Migration Guide|Migration21]].

diff --git a/documentation/manual/releases/release23/Highlights23.md b/documentation/manual/releases/release23/Highlights23.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.3
 
 This page highlights the new features of Play 2.3. If you want learn about the changes you need to make to migrate to Play 2.3, check out the [[Play 2.3 Migration Guide|Migration23]].

diff --git a/documentation/manual/releases/release23/Migration23.md b/documentation/manual/releases/release23/Migration23.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play 2.3 Migration Guide
 
 This is a guide for migrating from Play 2.2 to Play 2.3. If you need to migrate from an earlier version of Play then you must first follow the [[Play 2.2 Migration Guide|Migration22]].

diff --git a/documentation/manual/releases/release24/Highlights24.md b/documentation/manual/releases/release24/Highlights24.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.4
 
 This page highlights the new features of Play 2.4. If you want learn about the changes you need to make to migrate to Play 2.4, check out the [[Play 2.4 Migration Guide|Migration24]].

diff --git a/documentation/manual/releases/release24/ReactiveStreamsIntegration.md b/documentation/manual/releases/release24/ReactiveStreamsIntegration.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Reactive Streams integration (experimental)
 
 > **Play experimental libraries are not ready for production use**. APIs may change. Features may not work properly.

diff --git a/documentation/manual/releases/release24/migration24/Anorm.md b/documentation/manual/releases/release24/migration24/Anorm.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Anorm
 
 Anorm has been pulled out of the core of Play into a separately managed project that can have its own lifecycle.  To add a dependency on it, use:

diff --git a/documentation/manual/releases/release24/migration24/GlobalSettings.md b/documentation/manual/releases/release24/migration24/GlobalSettings.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Removing `GlobalSettings`
 
 If you are keen to use dependency injection, we are recommending that you move out of your `GlobalSettings` implementation class as much code as possible. Ideally, you should be able to refactor your code so that it is possible to eliminate your `GlobalSettings` class altogether.

diff --git a/documentation/manual/releases/release24/migration24/Migration24.md b/documentation/manual/releases/release24/migration24/Migration24.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play 2.4 Migration Guide
 
 This is a guide for migrating from Play 2.3 to Play 2.4. If you need to migrate from an earlier version of Play then you must first follow the [[Play 2.3 Migration Guide|Migration23]].

diff --git a/documentation/manual/releases/release24/migration24/PluginsToModules.md b/documentation/manual/releases/release24/migration24/PluginsToModules.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Migrating Plugin to Module
 
 > **Note:** The deprecated `play.Plugin` system is removed as of 2.5.x.

diff --git a/documentation/manual/releases/release25/Highlights25.md b/documentation/manual/releases/release25/Highlights25.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.5
 
 This page highlights the new features of Play 2.5. If you want to learn about the changes you need to make to migrate to Play 2.5, check out the [[Play 2.5 Migration Guide|Migration25]].

diff --git a/documentation/manual/releases/release25/migration25/CryptoMigration25.md b/documentation/manual/releases/release25/migration25/CryptoMigration25.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Crypto Migration Guide
 
 From Play 1.x, Play has come with a Crypto object that provides some cryptographic operations.  This used internally by Play.  The Crypto object is not mentioned in the documentation, but is mentioned as "cryptographic utilities" in the scaladoc:

diff --git a/documentation/manual/releases/release25/migration25/JavaMigration25.md b/documentation/manual/releases/release25/migration25/JavaMigration25.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Java Migration Guide
 
 In order to better fit in to the Java 8 ecosystem, and to allow Play Java users to make more idiomatic use of Java in their applications, Play has switched to using a number of Java 8 types such as `CompletionStage` and `Function`. Play also has new Java APIs for `EssentialAction`, `EssentialFilter`, `Router`, `BodyParser` and `HttpRequestHandler`.

diff --git a/documentation/manual/releases/release25/migration25/Migration25.md b/documentation/manual/releases/release25/migration25/Migration25.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play 2.5 Migration Guide
 
 This is a guide for migrating from Play 2.4 to Play 2.5. If you need to migrate from an earlier version of Play then you must first follow the [[Play 2.4 Migration Guide|Migration24]].

diff --git a/documentation/manual/releases/release25/migration25/StreamsMigration25.md b/documentation/manual/releases/release25/migration25/StreamsMigration25.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Streams Migration Guide
 
 Play 2.5 has made several major changes to how it streams data and response bodies.

diff --git a/documentation/manual/releases/release26/Highlights26.md b/documentation/manual/releases/release26/Highlights26.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.6
 
 This page highlights the new features of Play 2.6. If you want to learn about the changes you need to make when you migrate to Play 2.6, check out the [[Play 2.6 Migration Guide|Migration26]].

diff --git a/documentation/manual/releases/release26/migration26/CacheMigration26.md b/documentation/manual/releases/release26/migration26/CacheMigration26.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Cache APIs Migration
 
 ## New packages

diff --git a/documentation/manual/releases/release26/migration26/JPAMigration26.md b/documentation/manual/releases/release26/migration26/JPAMigration26.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # JPA Migration
 
 ## Removed Deprecated Methods

diff --git a/documentation/manual/releases/release26/migration26/MessagesMigration26.md b/documentation/manual/releases/release26/migration26/MessagesMigration26.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # I18N API Migration
 
 There are a number of changes to the I18N API to make working with messages and languages easier to use, particularly with forms and templates.

diff --git a/documentation/manual/releases/release26/migration26/Migration26.md b/documentation/manual/releases/release26/migration26/Migration26.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play 2.6 Migration Guide
 
 This is a guide for migrating from Play 2.5 to Play 2.6. If you need to migrate from an earlier version of Play then you must first follow the [[Play 2.5 Migration Guide|Migration25]].

diff --git a/documentation/manual/releases/release26/migration26/WSMigration26.md b/documentation/manual/releases/release26/migration26/WSMigration26.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play WS Migration Guide
 
 Play WS now has a standalone version - [https://github.com/playframework/play-ws](https://github.com/playframework/play-ws) - that can be used outside a Play project. If you have a Play sbt project, you can still add WS by adding the following line to your `build.sbt`:

diff --git a/documentation/manual/releases/release27/Highlights27.md b/documentation/manual/releases/release27/Highlights27.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.7
 
 This page highlights the new features of Play 2.7. If you want to learn about the changes you need to make when you migrate to Play 2.7, check out the [[Play 2.7 Migration Guide|Migration27]].

diff --git a/documentation/manual/releases/release28/Highlights28.md b/documentation/manual/releases/release28/Highlights28.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.8
 
 This page highlights the new features of Play 2.8. If you want to learn about the changes you need to make when you migrate to Play 2.8, check out the [[Play 2.8 Migration Guide|Migration28]].

diff --git a/documentation/manual/releases/release29/Highlights29.md b/documentation/manual/releases/release29/Highlights29.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # What's new in Play 2.9
 
 This page highlights the new features of Play 2.9. If you want to learn about the changes you need to make when you migrate to Play 2.9, check out the [[Play 2.9 Migration Guide|Migration29]].

diff --git a/documentation/manual/tutorial/Tutorials.md b/documentation/manual/tutorial/Tutorials.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Play Tutorials
 
 Play's documentation shows the available features and how to use them, but the documentation will not show how to create an application from start to finish.  This is where tutorials and examples come in.

diff --git a/documentation/manual/working/commonGuide/Modules.md b/documentation/manual/working/commonGuide/Modules.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Extending Play with modules
 
 At its core, Play is a very lightweight HTTP server, providing mechanisms for serving HTTP requests, but not much else. Additional functionality in Play is provided through the use of Play modules.

diff --git a/documentation/manual/working/commonGuide/akka/AkkaClusterSharding.md b/documentation/manual/working/commonGuide/akka/AkkaClusterSharding.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Cluster Sharding for Akka Typed (incubating)
 
 Play provides an [incubating](https://developer.lightbend.com/docs/lightbend-platform/introduction/getting-help/support-terminology.html) module for integration with [Akka Cluster Sharding Typed](https://doc.akka.io/docs/akka/2.6/typed/cluster-sharding.html). To enable this module, add the following dependency to your build:

diff --git a/documentation/manual/working/commonGuide/akka/AkkaIntegrations.md b/documentation/manual/working/commonGuide/akka/AkkaIntegrations.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Akka Advanced Integrations
 
 This section covers some topics related to working with advanced features in Akka.

diff --git a/documentation/manual/working/commonGuide/akka/AkkaTyped.md b/documentation/manual/working/commonGuide/akka/AkkaTyped.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Integrating with Akka Typed
 
 Akka 2.6 marked the new typed Actor API ("Akka Typed") as stable. The typed API is now officially the main API for Akka. In the typed API, each actor needs to declares which message type it is able to handle and the type system enforces that only messages of this type can be sent to the actor. Although Play does not fully adopt Akka Typed, we already provide some APIs to better integrate it in Play applications.

diff --git a/documentation/manual/working/commonGuide/assets/Assets.md b/documentation/manual/working/commonGuide/assets/Assets.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Static assets
 
 This section covers serving your application’s static resources such as JavaScript, CSS and images.

diff --git a/documentation/manual/working/commonGuide/assets/AssetsCoffeeScript.md b/documentation/manual/working/commonGuide/assets/AssetsCoffeeScript.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Using CoffeeScript
 
 [CoffeeScript](https://coffeescript.org/) is a small and elegant language that compiles into JavaScript. It provides a nice syntax for writing JavaScript code.

diff --git a/documentation/manual/working/commonGuide/assets/AssetsJSHint.md b/documentation/manual/working/commonGuide/assets/AssetsJSHint.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Using JSHint
 
 From its [website documentation](https://jshint.com/about/):

diff --git a/documentation/manual/working/commonGuide/assets/AssetsLess.md b/documentation/manual/working/commonGuide/assets/AssetsLess.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Using LESS CSS
 
 [LESS CSS](http://lesscss.org/) is a dynamic stylesheet language. It allows considerable flexibility in the way you write CSS files including support for variables, mixins and more.

diff --git a/documentation/manual/working/commonGuide/assets/AssetsOverview.md b/documentation/manual/working/commonGuide/assets/AssetsOverview.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Working with public assets
 
 Serving a public resource in Play is the same as serving any other HTTP request. It uses the same routing as regular resources using the controller/action path to distribute CSS, JavaScript or image files to the client.

diff --git a/documentation/manual/working/commonGuide/assets/AssetsSass.md b/documentation/manual/working/commonGuide/assets/AssetsSass.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Using Sass
 
 [Sass](https://sass-lang.com/) is a dynamic stylesheet language. It allows considerable flexibility in the way you write CSS files including support for variables, mixins and more.

diff --git a/documentation/manual/working/commonGuide/assets/RequireJS-support.md b/documentation/manual/working/commonGuide/assets/RequireJS-support.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # RequireJS
 
 According to [RequireJS](https://requirejs.org/)' website 

diff --git a/documentation/manual/working/commonGuide/build/AggregatingReverseRouters.md b/documentation/manual/working/commonGuide/build/AggregatingReverseRouters.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Aggregating reverse routers
 
 In some situations you want to share reverse routers between sub projects that are not dependent on each other.

diff --git a/documentation/manual/working/commonGuide/build/Build.md b/documentation/manual/working/commonGuide/build/Build.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # The build system
 
 This section gives details about Play's build system.

diff --git a/documentation/manual/working/commonGuide/build/BuildOverview.md b/documentation/manual/working/commonGuide/build/BuildOverview.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Overview of the build system
 
 The Play build system uses [sbt](https://www.scala-sbt.org/), a high-performance integrated build for Scala and Java projects.  Using `sbt` as our build tool brings certain requirements to play which are explained on this page.

diff --git a/documentation/manual/working/commonGuide/build/CompilationSpeed.md b/documentation/manual/working/commonGuide/build/CompilationSpeed.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Improving Compilation Times
 
 Compilation speed can be improved by following some guidelines that are also good engineering practice:

diff --git a/documentation/manual/working/commonGuide/build/sbtCookbook.md b/documentation/manual/working/commonGuide/build/sbtCookbook.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # sbt Cookbook
 
 ## Hooking into Play's dev mode

diff --git a/documentation/manual/working/commonGuide/build/sbtDebugging.md b/documentation/manual/working/commonGuide/build/sbtDebugging.md
@@ -1,4 +1,5 @@
 <!--- Copyright (C) Lightbend Inc. <https://www.lightbend.com> -->
+
 # Debugging your build
 
 If you are having difficulties getting sbt to do what you want it to do, you may need to use some of the built in utilities that sbt provides to help you debug your build.