diff --git a/docs/best-practices/security/security.md b/best-practices/security/security.md
similarity index 100%
rename from docs/best-practices/security/security.md
rename to best-practices/security/security.md
diff --git a/docs/best-practices/troubleshooting/README.md b/best-practices/troubleshooting/README.md
similarity index 100%
rename from docs/best-practices/troubleshooting/README.md
rename to best-practices/troubleshooting/README.md
diff --git a/docs/best-practices/troubleshooting/common_issues.md b/best-practices/troubleshooting/common_issues.md
similarity index 100%
rename from docs/best-practices/troubleshooting/common_issues.md
rename to best-practices/troubleshooting/common_issues.md
diff --git a/docs/best-practices/troubleshooting/logs.md b/best-practices/troubleshooting/logs.md
similarity index 100%
rename from docs/best-practices/troubleshooting/logs.md
rename to best-practices/troubleshooting/logs.md
diff --git a/docs/best-practices/troubleshooting/profiling_debugging.md b/best-practices/troubleshooting/profiling_debugging.md
similarity index 100%
rename from docs/best-practices/troubleshooting/profiling_debugging.md
rename to best-practices/troubleshooting/profiling_debugging.md
diff --git a/docs/best-practices/troubleshooting/tracing.md b/best-practices/troubleshooting/tracing.md
similarity index 100%
rename from docs/best-practices/troubleshooting/tracing.md
rename to best-practices/troubleshooting/tracing.md
diff --git a/docs/concepts/actor/actor_pattern.md b/concepts/actor/actor_pattern.md
similarity index 100%
rename from docs/concepts/actor/actor_pattern.md
rename to concepts/actor/actor_pattern.md
diff --git a/docs/concepts/actor/actors_integration.md b/concepts/actor/actors_integration.md
similarity index 100%
rename from docs/concepts/actor/actors_integration.md
rename to concepts/actor/actors_integration.md
diff --git a/docs/concepts/actor/enable_actor_pattern.md b/concepts/actor/enable_actor_pattern.md
similarity index 100%
rename from docs/concepts/actor/enable_actor_pattern.md
rename to concepts/actor/enable_actor_pattern.md
diff --git a/docs/concepts/architecture/architecture.md b/concepts/architecture/architecture.md
similarity index 100%
rename from docs/concepts/architecture/architecture.md
rename to concepts/architecture/architecture.md
diff --git a/docs/concepts/bindings/bindings.md b/concepts/bindings/bindings.md
similarity index 100%
rename from docs/concepts/bindings/bindings.md
rename to concepts/bindings/bindings.md
diff --git a/docs/concepts/extending-actions/extending-actions.md b/concepts/extending-actions/extending-actions.md
similarity index 100%
rename from docs/concepts/extending-actions/extending-actions.md
rename to concepts/extending-actions/extending-actions.md
diff --git a/docs/concepts/publish-subscribe-messaging/pub-sub-messaging.md b/concepts/publish-subscribe-messaging/pub-sub-messaging.md
similarity index 100%
rename from docs/concepts/publish-subscribe-messaging/pub-sub-messaging.md
rename to concepts/publish-subscribe-messaging/pub-sub-messaging.md
diff --git a/docs/concepts/security/security.md b/concepts/security/security.md
similarity index 100%
rename from docs/concepts/security/security.md
rename to concepts/security/security.md
diff --git a/docs/concepts/service-invocation/service-invocation.md b/concepts/service-invocation/service-invocation.md
similarity index 100%
rename from docs/concepts/service-invocation/service-invocation.md
rename to concepts/service-invocation/service-invocation.md
diff --git a/docs/concepts/state-management/state-management.md b/concepts/state-management/state-management.md
similarity index 100%
rename from docs/concepts/state-management/state-management.md
rename to concepts/state-management/state-management.md
diff --git a/docs/concepts/terminology/terminology.md b/concepts/terminology/terminology.md
similarity index 100%
rename from docs/concepts/terminology/terminology.md
rename to concepts/terminology/terminology.md
diff --git a/docs/concepts/tracing-logging/tracing-logging.md b/concepts/tracing-logging/tracing-logging.md
similarity index 100%
rename from docs/concepts/tracing-logging/tracing-logging.md
rename to concepts/tracing-logging/tracing-logging.md
diff --git a/docs/getting-started/setup-development-environment.md b/getting-started/setup-development-environment.md
similarity index 100%
rename from docs/getting-started/setup-development-environment.md
rename to getting-started/setup-development-environment.md
diff --git a/docs/getting-started/setup-kubernetes-environment .md b/getting-started/setup-kubernetes-environment .md
similarity index 100%
rename from docs/getting-started/setup-kubernetes-environment .md
rename to getting-started/setup-kubernetes-environment .md
diff --git a/docs/howto/diagnose-with-tracing/setup-development-environment.md b/howto/diagnose-with-tracing/setup-development-environment.md
similarity index 100%
rename from docs/howto/diagnose-with-tracing/setup-development-environment.md
rename to howto/diagnose-with-tracing/setup-development-environment.md
diff --git a/docs/howto/diagnose-with-tracing/setup-kubernetes-environment.md b/howto/diagnose-with-tracing/setup-kubernetes-environment.md
similarity index 100%
rename from docs/howto/diagnose-with-tracing/setup-kubernetes-environment.md
rename to howto/diagnose-with-tracing/setup-kubernetes-environment.md
diff --git a/docs/howto/setup-configure-even-bindings/configure-input-output-binding.md b/howto/setup-configure-even-bindings/configure-input-output-binding.md
similarity index 100%
rename from docs/howto/setup-configure-even-bindings/configure-input-output-binding.md
rename to howto/setup-configure-even-bindings/configure-input-output-binding.md
diff --git a/docs/howto/setup-configure-even-bindings/supported-bindings.md b/howto/setup-configure-even-bindings/supported-bindings.md
similarity index 100%
rename from docs/howto/setup-configure-even-bindings/supported-bindings.md
rename to howto/setup-configure-even-bindings/supported-bindings.md
diff --git a/docs/howto/setup-pub-sub-message-broker/setup-kafka.md b/howto/setup-pub-sub-message-broker/setup-kafka.md
similarity index 100%
rename from docs/howto/setup-pub-sub-message-broker/setup-kafka.md
rename to howto/setup-pub-sub-message-broker/setup-kafka.md
diff --git a/docs/howto/setup-pub-sub-message-broker/setup-redis.md b/howto/setup-pub-sub-message-broker/setup-redis.md
similarity index 100%
rename from docs/howto/setup-pub-sub-message-broker/setup-redis.md
rename to howto/setup-pub-sub-message-broker/setup-redis.md
diff --git a/docs/howto/setup-pub-sub-message-broker/supported-message-brokers.md b/howto/setup-pub-sub-message-broker/supported-message-brokers.md
similarity index 100%
rename from docs/howto/setup-pub-sub-message-broker/supported-message-brokers.md
rename to howto/setup-pub-sub-message-broker/supported-message-brokers.md
diff --git a/docs/howto/setup-state-store/setup-azure-cosmosdb.md b/howto/setup-state-store/setup-azure-cosmosdb.md
similarity index 100%
rename from docs/howto/setup-state-store/setup-azure-cosmosdb.md
rename to howto/setup-state-store/setup-azure-cosmosdb.md
diff --git a/docs/howto/setup-state-store/setup-redis.md b/howto/setup-state-store/setup-redis.md
similarity index 100%
rename from docs/howto/setup-state-store/setup-redis.md
rename to howto/setup-state-store/setup-redis.md
diff --git a/docs/howto/setup-state-store/supported-state-stores.md b/howto/setup-state-store/supported-state-stores.md
similarity index 100%
rename from docs/howto/setup-state-store/supported-state-stores.md
rename to howto/setup-state-store/supported-state-stores.md
diff --git a/docs/images/actions_k8s.png b/images/actions_k8s.png
similarity index 100%
rename from docs/images/actions_k8s.png
rename to images/actions_k8s.png
diff --git a/docs/images/actions_k8s_success.png b/images/actions_k8s_success.png
similarity index 100%
rename from docs/images/actions_k8s_success.png
rename to images/actions_k8s_success.png
diff --git a/docs/images/actions_orleans.png b/images/actions_orleans.png
similarity index 100%
rename from docs/images/actions_orleans.png
rename to images/actions_orleans.png
diff --git a/docs/images/actions_standalone.png b/images/actions_standalone.png
similarity index 100%
rename from docs/images/actions_standalone.png
rename to images/actions_standalone.png
diff --git a/docs/images/actor_pattern.png b/images/actor_pattern.png
similarity index 100%
rename from docs/images/actor_pattern.png
rename to images/actor_pattern.png
diff --git a/docs/images/actors_client.png b/images/actors_client.png
similarity index 100%
rename from docs/images/actors_client.png
rename to images/actors_client.png
diff --git a/docs/images/actors_server.png b/images/actors_server.png
similarity index 100%
rename from docs/images/actors_server.png
rename to images/actors_server.png
diff --git a/docs/images/alloc.png b/images/alloc.png
similarity index 100%
rename from docs/images/alloc.png
rename to images/alloc.png
diff --git a/docs/images/dynamic_range.png b/images/dynamic_range.png
similarity index 100%
rename from docs/images/dynamic_range.png
rename to images/dynamic_range.png
diff --git a/docs/images/heap.png b/images/heap.png
similarity index 100%
rename from docs/images/heap.png
rename to images/heap.png
diff --git a/docs/images/programming_experience.png b/images/programming_experience.png
similarity index 100%
rename from docs/images/programming_experience.png
rename to images/programming_experience.png
diff --git a/docs/images/sample_trace.png b/images/sample_trace.png
similarity index 100%
rename from docs/images/sample_trace.png
rename to images/sample_trace.png
diff --git a/docs/images/zipkin_ui.png b/images/zipkin_ui.png
similarity index 100%
rename from docs/images/zipkin_ui.png
rename to images/zipkin_ui.png
diff --git a/docs/quickstart/kubernetes-development.md b/quickstart/kubernetes-development.md
similarity index 100%
rename from docs/quickstart/kubernetes-development.md
rename to quickstart/kubernetes-development.md
diff --git a/docs/quickstart/local-development.md b/quickstart/local-development.md
similarity index 100%
rename from docs/quickstart/local-development.md
rename to quickstart/local-development.md
diff --git a/docs/reference/cli.md b/reference/cli.md
similarity index 100%
rename from docs/reference/cli.md
rename to reference/cli.md
diff --git a/docs/reference/specification.md b/reference/specification.md
similarity index 100%
rename from docs/reference/specification.md
rename to reference/specification.md
diff --git a/docs/tutorials/actors/create-.net-actor-application.md b/tutorials/actors/create-.net-actor-application.md
similarity index 100%
rename from docs/tutorials/actors/create-.net-actor-application.md
rename to tutorials/actors/create-.net-actor-application.md