diff --git a/README.md b/README.md
index 425f8974b9..3cf1470386 100644
--- a/README.md
+++ b/README.md
@@ -305,15 +305,15 @@ Other languages have petstore samples, too:
 ```
 ### Customization
 
-Please refer to [customization.md](customization.md) on how to customize the output (e.g. package name, version)
+Please refer to [customization.md](docs/customization.md) on how to customize the output (e.g. package name, version)
 
 ### Workflow Integration (Maven, Gradle, Github, CI/CD)
 
-Please refer to [integration.md](integration.md) on how to integrate OpenAPI generator with Maven, Gradle, Github and CI/CD.
+Please refer to [integration.md](docs/integration.md) on how to integrate OpenAPI generator with Maven, Gradle, Github and CI/CD.
 
 ### Online OpenAPI generator
 
-Please refer to [online-openapi-generator.md](online-openapi-generator.md) on how to run and use the `openapi-generator-online` - a web service for `openapi-generator`.
+Please refer to [online-openapi-generator.md](docs/online-openapi-generator.md) on how to run and use the `openapi-generator-online` - a web service for `openapi-generator`.
 
 ### License information on Generated Code
 
diff --git a/customization.md b/docs/customization.md
similarity index 100%
rename from customization.md
rename to docs/customization.md
diff --git a/integration.md b/docs/integration.md
similarity index 95%
rename from integration.md
rename to docs/integration.md
index 9097361c7a..1430ca6b6b 100644
--- a/integration.md
+++ b/docs/integration.md
@@ -30,4 +30,4 @@ Some generators also generate CI/CD configuration files (.travis.yml) so that th
 
 If you're looking for the configuration files of a particular CI that is not yet supported, please open an [issue](https://github.com/swagger-api/swagger-codegen/issues/new) to let us know.
 
-[Back to OpenAPI-Generator's README page](README.md)
+[Back to OpenAPI-Generator's README page](../README.md)
diff --git a/online-openapi-generator.md b/docs/online-openapi-generator.md
similarity index 100%
rename from online-openapi-generator.md
rename to docs/online-openapi-generator.md