About

When using the search on this documentation section, for example per https://crate.io/docs/cloud/en/latest/search.html?q=subscription%20plans, it does not display any results from here at all.

About

While the Tutorials (https://cratedb.com/docs/cloud/en/latest/tutorials/index.html) articles in cloud docs are great content, they are not really Cloud specific. Moving them to the new Guide (https://cratedb.com/docs/guide/) section sounds more reasonable.
https://cratedb.com/docs/cloud/en/latest/tutorials/index.html -> https://cratedb.com/docs/guide/

References

• crate/cratedb-guide#70

About

• crate-docs-theme==0.29.0 has been released, including the updates to the primary navigation coming from crate/crate-docs-theme#391.
• The reworked CrateDB Cloud Docs project already has it, see https://crate.io/docs/cloud/. Other projects will need to be rebuilt.
• Navigation seems to work well, or will work well, when all pages have been refreshed in Fastly's cache.

Details

On the preview page, and in this screenshot, you will see both toctree variants currently defined at cloud-docs:/docs/index.md.

The bottom section reflects the previous physical structure "Reference vs. Tutorials vs. How-To Guides", and the top section is made of a handcrafted toctree, which is reflecting the same structure and the order of the items from the "Manage" section of that page, directly referencing corresponding sections of the documentation, no matter where they are located.

Q&A

On this matter, I am asking which variant you would prefer? I think the handcrafted version has a point, while the other one, based on the previous physical structure, will be dissolved anyway in the course of the next iterations? Let me know if you have a different opinion, or other suggestions about this layout/design/structure/UX detail.

/cc @kojinkai, @SStorm, @matkuliak, @msbt

Who

A CrateDB user

What

Learn about best practices on how to optimize their CrateDB Cluster

Why

To now which best practices to apply for which scenarios

ACs

• A blogpost about 3-5 performance tuning best practices is available as a draft
• How to setup the best practises is explained step-by-step
• Pros/Cons and implications are described for each best practice
• Blogpost is reviewed with important stakeholders (CrateDB, CE)
• Blogpost is published

About

Now, after getting the repository reasonably into shape, the next steps are about sanding it properly.

@proddata already offered two valuable suggestions where to improve right away.

• I can imagine all the (Sign Up, Free Trial, Deploy) sections on two pages. We don’t need to explain every step of how to create a user account.
• Regarding the payment options, it really just is a single payment method currently. It was a bit different in the past.

About

After releasing this canonical repository for Cloud documentation today, the search functionality might have stopped working / is not configured correctly yet. You can verify it by using this link: https://crate.io/docs/cloud/en/latest/search.html?q=azure.

Document a new feature in the Cloud product

Documentation feedback

The images on this page that have :scale: 50% via https://github.com/crate/cloud-docs/blob/main/docs/tutorials/edge/introduction.rst?plain=1#L310-L312 (and probably all others that use this) are skewed/stretched. I thought that bug was fixed, but apparently it's not. There's a card on the website board which describes possible solutions, please ping me if/when you have bandwidth for that @amotl @matkuliak

• Page title: Introduction
• Page URL: https://cratedb.com/docs/cloud/en/latest/tutorials/edge/introduction.html
• Source: https://github.com/crate/cloud-docs/blob/main/docs/tutorials/edge/introduction.rst