From 493648d97920299d78957c95539d39650a6b2fdf Mon Sep 17 00:00:00 2001 From: Enno Runne <458526+ennru@users.noreply.github.com> Date: Fri, 6 Dec 2024 11:58:00 +0100 Subject: [PATCH] docs: review support pages (#64) --- .../pages/projects/container-registries.adoc | 2 +- docs/src/modules/support/nav.adoc | 6 +++++- docs/src/modules/support/pages/community-forum.adoc | 2 +- docs/src/modules/support/pages/email.adoc | 2 +- .../support/pages/frequently-asked-questions.adoc | 10 +++------- docs/src/modules/support/pages/paid-plans.adoc | 4 ++-- docs/src/modules/support/pages/request-a-demo.adoc | 2 +- docs/src/modules/support/pages/troubleshooting.adoc | 7 ++++--- 8 files changed, 18 insertions(+), 17 deletions(-) diff --git a/docs/src/modules/operations/pages/projects/container-registries.adoc b/docs/src/modules/operations/pages/projects/container-registries.adoc index abcb36d9b..1bc8892a3 100644 --- a/docs/src/modules/operations/pages/projects/container-registries.adoc +++ b/docs/src/modules/operations/pages/projects/container-registries.adoc @@ -9,7 +9,7 @@ Akka provides a built-in _Akka Container Registry (ACR)_ which is pre-configured == Akka Container Registry -The _Akka Container Registry (ACR)_ is available to all Akka users and supported across all Akka regions, allowing for easy, integrated deployments without dependency on external registry connectivity. Authentication is built-in, so deployments, restarts, and scaling operate independently from external networks. +The _Akka Container Registry (ACR)_ is available to all Akka users and supported across all Akka regions, allowing for easy, integrated deployments without dependency on external registry connectivity. Authentication is built-in, so deployments, restarts, and scaling operate independently of external networks. == Prerequisites diff --git a/docs/src/modules/support/nav.adoc b/docs/src/modules/support/nav.adoc index dcb24ff79..6fbe263f9 100644 --- a/docs/src/modules/support/nav.adoc +++ b/docs/src/modules/support/nav.adoc @@ -3,4 +3,8 @@ * xref:support:index.adoc[] ** xref:support:community-forum.adoc[] ** xref:support:email.adoc[] -** xref:support:platform-status.adoc[] \ No newline at end of file +** xref:support:frequently-asked-questions.adoc[] +** xref:support:paid-plans.adoc[] +** xref:support:platform-status.adoc[] +** xref:support:request-a-demo.adoc[] +** xref:support:troubleshooting.adoc[] diff --git a/docs/src/modules/support/pages/community-forum.adoc b/docs/src/modules/support/pages/community-forum.adoc index 1367e91ef..65536a2fe 100644 --- a/docs/src/modules/support/pages/community-forum.adoc +++ b/docs/src/modules/support/pages/community-forum.adoc @@ -12,4 +12,4 @@ include::ROOT:partial$include.adoc[] [sidebar] -https://discuss.akka.io/[Join the Akka Community Forum] \ No newline at end of file +https://discuss.akka.io/c/akka-sdk/43[Join the Akka Community Forum] diff --git a/docs/src/modules/support/pages/email.adoc b/docs/src/modules/support/pages/email.adoc index 9e9e19a61..569d45a1b 100644 --- a/docs/src/modules/support/pages/email.adoc +++ b/docs/src/modules/support/pages/email.adoc @@ -6,4 +6,4 @@ include::ROOT:partial$include.adoc[] Connect with a member of the Akka team for advice and support on your project. -Browse to https://www.akka.io/contact[https://www.akka.io/contact,window="new"], provide the necessary details and submit the form. A team member will reach out to you shortly. \ No newline at end of file +Browse to https://akka.io/contact-us[akka.io/contact-us,window="new"], provide the necessary details and submit the form. A team member will reach out to you shortly. diff --git a/docs/src/modules/support/pages/frequently-asked-questions.adoc b/docs/src/modules/support/pages/frequently-asked-questions.adoc index 616c8b06e..c8f4493e9 100644 --- a/docs/src/modules/support/pages/frequently-asked-questions.adoc +++ b/docs/src/modules/support/pages/frequently-asked-questions.adoc @@ -43,8 +43,8 @@ In one sentence: "High performance and very low latency in an extremely cost-eff In a few more words, with Akka, companies can: -- Provide higher agility to ever changing market demands: Legacy infrastructure and architectures make it very expensive to deliver scalable solutions quickly. Akka let's you circumvent all those technical limitations. -- Increase the speed to innovation: Distributed compute and data have long been purview of expert engineers proficient in narrow scope of programming languages. Akka makes building these kinds of applications straight-forward in languages you already know and use. +- Provide higher agility to ever-changing market demands: Legacy infrastructure and architectures make it very expensive to deliver scalable solutions quickly. Akka lets you circumvent all those technical limitations. +- Increase the speed to innovation: Distributed compute and data have long been purview of expert engineers proficient in narrow scope of programming languages. Akka makes building these kinds of applications straight-forward. - Lower infrastructure costs: Scalable cloud architectures are difficult to operate, require large teams of costly resources and run significant risk of unexpected budget overages. Akka will charge for what you use, not what you might need (when generally available). == What are the benefits for developers? @@ -63,10 +63,6 @@ Yes! Akka is a single globally distributed state model. Teams anywhere in the wo Akka leverages the proven Akka reactive architecture for building stateful, high-performance, business-critical systems, without the developer needing to understand the complexities of Akka itself or distributed systems architecture in general. -== What languages are supported? - -Akka supports Java and Scala. For a detailed overview of supported features see xref:reference:feature-matrix[Feature Matrix] section. - == What are the resource limits of an Akka service? Individual requests and responses, states and events can in general have a payload size up to 12 Mb. @@ -117,7 +113,7 @@ The short answer is no. Please see the documentation on xref:support:paid-plans. === How do I purchase a paid plan? -https://www.akka.io/contact[Contact Lightbend] to purchase a paid plan. See the https://www.akka.io/pricing[pricing page] for purchase options. +https://akka.io/contact-us[Contact Akka] to purchase a paid plan. See the https://akka.io/pricing[pricing page] for purchase options. == What if I have additional questions or want to provide feedback? diff --git a/docs/src/modules/support/pages/paid-plans.adoc b/docs/src/modules/support/pages/paid-plans.adoc index 341829ea2..7d5e7708e 100644 --- a/docs/src/modules/support/pages/paid-plans.adoc +++ b/docs/src/modules/support/pages/paid-plans.adoc @@ -15,7 +15,7 @@ Upgrading to a paid plan offer several benefits: == Upgrading to a paid plan -To upgrade, please https://www.akka.io/contact[contact Akka,window="new"]. +To upgrade, please https://akka.io/contact-us[contact Akka,window="new"]. You will be required to provide: @@ -27,4 +27,4 @@ You will be required to provide: == Billing models -Please see the https://www.akka.io/pricing[Akka Pricing] page for more details on billing models, features and pricing. +Please see the https://akka.io/pricing[Akka Pricing] page for more details on billing models, features and pricing. diff --git a/docs/src/modules/support/pages/request-a-demo.adoc b/docs/src/modules/support/pages/request-a-demo.adoc index c24e30bc4..350b248c4 100644 --- a/docs/src/modules/support/pages/request-a-demo.adoc +++ b/docs/src/modules/support/pages/request-a-demo.adoc @@ -6,4 +6,4 @@ include::ROOT:partial$include.adoc[] We'd love to learn about your requirements, answer your unique questions, and review ways that Akka can help you and your organization. -Browse to https://www.akka.io/contact[https://www.akka.io/contact,window="new"], provide the necessary details and submit the form. A team member will reach out to you shortly. \ No newline at end of file +Browse to https://akka.io/contact-us[akka.io/contact-us,window="new"], provide the necessary details and submit the form. A team member will reach out to you shortly. diff --git a/docs/src/modules/support/pages/troubleshooting.adoc b/docs/src/modules/support/pages/troubleshooting.adoc index 58ef9b9b0..504cf0276 100644 --- a/docs/src/modules/support/pages/troubleshooting.adoc +++ b/docs/src/modules/support/pages/troubleshooting.adoc @@ -22,7 +22,8 @@ NOTE: You can check the version of the Akka CLI you have by running `akka versio When you see the following error: -``` +[source] +---- [ERROR] /path/to/file.proto [0:0]: --akka-grpc_out: protoc-gen-akka-grpc: Plugin output is unparseable: [0.001s][warning][os,container] Duplicate cpuset controllers detected. Picking /sys/fs/cgroup/cpuset, skipping /host/sys/fs/cgroup/cpuset. (...) [INFO] ------------------------------------------------------------------------ @@ -32,7 +33,7 @@ When you see the following error: [INFO] Finished at: 2022-03-07T15:31:49Z [INFO] ------------------------------------------------------------------------ [ERROR] Failed to execute goal org.xolstice.maven.plugins:protobuf-maven-plugin:0.6.1:compile (protobuf) on project customer-registry: protoc did not exit cleanly. Review output for more information. -> [Help 1] -``` +---- This problem is caused by JDK17 https://bugs.openjdk.java.net/browse/JDK-8270087[reporting some warnings to `stdout` instead of `stderr`, window="new"]. The easiest way to resolve this is to avoid the situation leading to the warning, or switching to a JDK version without this bug, like JDK11. @@ -67,7 +68,7 @@ The same status message will appear within the System Lifecycle events window. *Options to resolve this issue include:* * Use a public repository -* Supply your xref:operations:projects/container-registries.adoc#_a_private_container_registry[credentials], and validate that they are correct. +* Supply your xref:operations:projects/external-container-registries.adoc[credentials], and validate that they are correct. == How to resolve errors when my deployment cannot start