Initial commit

docs/modules/ROOT/pages/community.adoc

@@ -0,0 +1,8 @@
+= Community
+:uri-github-issue: https://github.com/apple/pkl/issues
+:uri-github-discussions: https://github.com/apple/pkl/discussions
+
+We'd love to hear from you!
+
+* Create an {uri-github-issue}[issue]
+* Ask questions on {uri-github-discussions}[GitHub Discussions]

docs/modules/ROOT/pages/examples.adoc

@@ -0,0 +1,14 @@
+= Examples
+
+:uri-github-apple: https://github.com/apple
+:uri-jvm-examples: {uri-github-apple}/pkl-jvm-examples
+:uri-go-examples: {uri-github-apple}/pkl-go-examples
+:uri-swift-examples: {uri-github-apple}/pkl-swift-examples
+:uri-k8s-examples: {uri-github-apple}/pkl-k8s-examples
+
+For ready-to-go examples with full source code, see the various repositories that are available for you.
+
+* {uri-jvm-examples}[pkl-jvm-examples] -- for using Pkl within the JVM
+* {uri-swift-examples}[pkl-swift-examples] -- for using Pkl with Swift
+* {uri-go-examples}[pkl-go-examples] -- for using Pkl with Go
+* {uri-k8s-examples}[pkl-k8s-examples] -- for using Pkl with Kubernetes

docs/modules/ROOT/pages/index.adoc

@@ -0,0 +1,15 @@
+= User Manual
+include::../partials/component-attributes.adoc[]
+
+Quick Links: xref:pkl-cli:index.adoc#installation[Installation] | xref:language-reference:index.adoc[Language Reference]
+
+Pkl -- pronounced _Pickle_ -- is an embeddable configuration language which provides rich support for data templating and validation.
+It can be used from the command line, integrated in a build pipeline, or embedded in a program.
+Pkl scales from small to large, simple to complex, ad-hoc to repetitive configuration tasks.
+
+xref:introduction:index.adoc[Introduction]:: Why we created Pkl and what it can do for you.
+xref:language.adoc[Language]:: Get to know the language and standard library.
+xref:language-bindings.adoc[Bindings]:: Libraries for embedding Pkl into general-purpose languages.
+xref:tools.adoc[Tools]:: CLI, Gradle plugin, code generators, and other tools.
+link:{uri-pkl-examples-repo}[Examples]:: Ready-to-go examples with full source code.
+xref:release-notes:index.adoc[Release Notes]:: What's new in each release.

docs/modules/ROOT/pages/integrations.adoc

@@ -0,0 +1,3 @@
+= Framework Integrations
+
+* xref:spring:ROOT:index.adoc[Spring (Boot) Integration]

docs/modules/ROOT/pages/language-bindings.adoc

@@ -0,0 +1,6 @@
+= Language Bindings
+
+* xref:java-binding:index.adoc[Java]
+* xref:kotlin-binding:index.adoc[Kotlin]
+* xref:swift:ROOT:index.adoc[Swift]
+* xref:go:ROOT:index.adoc[Go]

docs/modules/ROOT/pages/language.adoc

@@ -0,0 +1,5 @@
+= Language
+
+* xref:language-tutorial:index.adoc[Tutorial]
+* xref:language-reference:index.adoc[Language Reference]
+* xref:standard-library.adoc[Standard Library]

docs/modules/ROOT/pages/resources.adoc

@@ -0,0 +1,7 @@
+= Resources
+include::../partials/component-attributes.adoc[]
+
+There's more to explore!
+
+* Visit Pkl's repositories on https://github.com/apple?q=pkl[GitHub]
+* Browse the standard library's https://pkl-lang.org/package-docs/pkl/{pkl-version}/[API Docs]

docs/modules/ROOT/pages/standard-library.adoc

@@ -0,0 +1,13 @@
+= Standard Library
+include::../partials/component-attributes.adoc[]
+
+The standard library is a set of Pkl modules, versioned and distributed together with the language.
+It is documented in the link:{uri-pkl-stdlib-docs-index}[API Docs].
+
+To import a standard library module, use `import "pkl:<identifier>"`.
+For example, `import "pkl:json"` imports the `pkl.json` module.
+
+The `pkl.base` module defines the most fundamental properties, methods, and classes for using Pkl.
+Its members are automatically available in every module and hence, it does not need to be imported.
+
+The default module allowlist (`--allowed-modules`) grants access to all standard library modules.

docs/modules/ROOT/pages/tools.adoc

@@ -0,0 +1,10 @@
+= Tools
+include::ROOT:partial$component-attributes.adoc[]
+
+* xref:pkl-cli:index.adoc[CLI]
+* xref:pkl-doc:index.adoc[Pkldoc]
+* xref:pkl-gradle:index.adoc[Gradle Plugin]
+* Editor support
+** xref:intellij:ROOT:index.adoc[IntelliJ]
+** xref:vscode:ROOT:index.adoc[VSCode]
+** xref:neovim:ROOT:index.adoc[Neovim]