doc: improve the ScyllaDB for Developers page

This commit improves the developer-oriented section
of the core documentation:

- Added links to the developer sections in the new
  Get Started guide (Develop with ScyllaDB and
  Tutorials and Example Projects) for ease of access.

- Replaced the outdated Learn to Use ScyllaDB page with
  a link to the up-to-date page in the Get Started guide.
  This involves removing the learn.rst file and adding
  an appropriate redirection.

- Removed the Apache Copyrights, as this page does not
  need it.

- Removed the Features panel box as there was only one
  feature listed, which looked weird. Also, we are in
  the process of removing the Features section.

Closes scylladb/scylladb#16800
This commit is contained in:
Anna Stuchlik
2024-01-16 13:26:54 +01:00
committed by Botond Dénes
parent ac473eca91
commit 9076a944c5
4 changed files with 23 additions and 113 deletions

View File

@@ -1,6 +1,9 @@
### a dictionary of redirections
#old path: new path
# Remove the Learn page (replaced with a link to a page in a different repo)
/stable/using-scylla/learn: https://docs.scylladb.com/stable/get-started/learn-resources/index.html
# Removed the outdated upgrade guides

View File

@@ -58,7 +58,6 @@ ScyllaDB for Administrators
:id: "getting-started"
:class: my-panel
* :doc:`Learn To Use Scylla </using-scylla/learn>` - Scylla University offers many courses. Pick a course and get started on your path to becoming a Scylla expert.
* :doc:`Scylla Features </using-scylla/features>` - Feature list for Scylla Open Source and Scylla Enterprise

View File

@@ -5,47 +5,40 @@ ScyllaDB for Developers
:maxdepth: 2
:hidden:
learn
Scylla Alternator <alternator/index>
Scylla Features <features>
Scylla Drivers <drivers/index>
Develop with ScyllaDB <https://docs.scylladb.com/stable/get-started/develop-with-scylladb/index.html>
Tutorials and Example Projects <https://docs.scylladb.com/stable/get-started/develop-with-scylladb/tutorials-example-projects.html>
Learn to Use ScyllaDB <https://docs.scylladb.com/stable/get-started/learn-resources/index.html>
ScyllaDB Alternator <alternator/index>
ScyllaDB Features <features>
ScyllaDB Drivers <drivers/index>
Workload Attributes <workload-attributes>
.. panel-box::
:title: Develop Your App with Scylla
:title: Get Started
:id: "getting-started"
:class: my-panel
* :doc:`Scylla Drivers </using-scylla/drivers/index>` - Scylla and third-party drivers for CQL and DynamoDB
* :doc:`Scylla Alternator </using-scylla/alternator/index>` - The Open Source DynamoDB-compatible API
* `Get Started with ScyllaDB <https://docs.scylladb.com/stable/get-started/index.html>`_
* `Tutorials and Example Projects <https://docs.scylladb.com/stable/get-started/develop-with-scylladb/tutorials-example-projects.html>`_
* `Learn to Use ScyllaDB <https://docs.scylladb.com/stable/get-started/learn-resources/index.html>`_
.. panel-box::
:title: Develop Your App with ScyllaDB
:id: "getting-started"
:class: my-panel
* :doc:`ScyllaDB Drivers </using-scylla/drivers/index>` - ScyllaDB and third-party drivers for CQL and DynamoDB
* :doc:`ScyllaDB Alternator </using-scylla/alternator/index>` - The Open Source DynamoDB-compatible API
* :doc:`CQL Reference </cql/index>` - Reference for the Apache Cassandra Query Language (CQL) and its ScyllaDB extensions
.. panel-box::
:title: Features
:id: "getting-started"
:class: my-panel
* :doc:`Workload Attributes </using-scylla/workload-attributes/>`
.. panel-box::
:title: Scylla Tools and Resources
:title: ScyllaDB Tools and Resources
:id: "getting-started"
:class: my-panel
* :doc:`Scylla Tools </operating-scylla/admin-tools/index>` - Tools for testing and integrating with Scylla
* :doc:`ScyllaDB Tools </operating-scylla/admin-tools/index>` - Tools for testing and integrating with Scylla
* :doc:`cqlsh </cql/cqlsh>` - A command line shell for interacting with ScyllaDB through CQL
.. panel-box::
:title: Learn More About Scylla
:id: "getting-started"
:class: my-panel
* :doc:`Learn To Use Scylla </using-scylla/learn/>` - Scylla University offers many courses. Pick a course and get started on your path to becoming a Scylla expert.
* :doc:`Scylla Features </using-scylla/features/>` - Feature list for Scylla Open Source and Scylla Enterprise
.. include:: /rst_include/apache-copyrights.rst

View File

@@ -1,85 +0,0 @@
======================
Learn To Use ScyllaDB
======================
.. toctree::
:maxdepth: 2
:hidden:
ScyllaDB University <https://university.scylladb.com/>
Course catalog <https://university.scylladb.com/available-courses/>
ScyllaDB Essentials <https://university.scylladb.com/courses/scylla-essentials-overview/>
Basic Data Modeling <https://university.scylladb.com/courses/data-modeling/lessons/basic-data-modeling-2/>
Advanced Data Modeling <https://university.scylladb.com/courses/data-modeling/lessons/advanced-data-modeling/>
MMS - Learn by Example <https://university.scylladb.com/courses/the-mutant-monitoring-system-training-course/>
Care-Pet an IoT Use Case and Example <https://iot.scylladb.com/>
.. panel-box::
:title: ScyllaDB University
:id: "getting-started"
:class: my-panel
See the `course catalog <https://university.scylladb.com/available-courses/>`_. Pick a course and get started on your path to becoming a ScyllaDB expert. Visit `ScyllaDB University <https://university.scylladb.com/>`_ to register!
.. panel-box::
:title: ScyllaDB Essentials
:id: "getting-started"
:class: my-panel
The `ScyllaDB Essentials - Overview of ScyllaDB and NoSQL Basics <https://university.scylladb.com/courses/scylla-essentials-overview/>`_ course explains basic concepts of NoSQL databases. You will gain knowledge of ScyllaDB features and advantages, including ScyllaDB architecture, data model and installation.
.. panel-box::
:title: Data Modeling
:id: "getting-started"
:class: my-panel
* `Basic Data Modeling <https://university.scylladb.com/courses/data-modeling/lessons/basic-data-modeling-2/>`_ - This is an intermediate level course that explains basic data modeling techniques including information on workflow application, query analysis, denormalization and other NoSQL data modeling topics.
* `Advanced Data Modeling <https://university.scylladb.com/courses/data-modeling/lessons/advanced-data-modeling/>`_ - This is an intermediate level course that explains advanced data modeling techniques including information on workflow application, query analysis, denormalization and other NoSQL data modeling topics.
* `How to Write Better Apps <https://university.scylladb.com/courses/data-modeling/lessons/how-to-write-better-apps/>`_ - An intermediate to advanced level lesson that explains how to write better applications. It covers application development, caveats, performance, and what you should or shouldnt do.
.. panel-box::
:title: ScyllaDB Operations
:id: "getting-started"
:class: my-panel
The course `ScyllaDB Operations and Administration <https://university.scylladb.com/courses/scylla-operations/>`_ is a more advanced course that covers different administration and operations topics such as Compaction, Security, Manager and Monitoring and much more.
.. panel-box::
:title: ScyllaDB Drivers
:id: "getting-started"
:class: my-panel
`Using ScyllaDB Drivers <https://university.scylladb.com/courses/using-scylla-drivers/>`_ focuses on ScyllaDB drivers and how to use them for application development. Some of the languages covered are Java, Python, Golang, Nodejs and Rust.
.. panel-box::
:title: ScyllaDB Alternator
:id: "getting-started"
:class: my-panel
`ScyllaDB Alternator <https://university.scylladb.com/courses/scylla-alternator//>`_ is an open-source project that gives ScyllaDB compatibility with DynamoDB. The course is work in progress, it covers migrating existing DynamoDB applications to work with ScyllaDB as well as creating new ones that use the DynamoDB API.
.. panel-box::
:title: Guided Exercises
:id: "getting-started"
:class: my-panel
* MMS Course: Mutants have emerged from the shadows and are wreaking havoc on Earth! `Learn ScyllaDB step by step <https://university.scylladb.com/courses/the-mutant-monitoring-system-training-course/>`_ though examples based on a "true story".
* Care-Pet: an IoT Use case example. `Learn to Use ScyllaDB <https://iot.scylladb.com/>`_ using this use case.
.. panel-box::
:title: Tech Talks and Scylla Summit Sessions
:id: "getting-started"
:class: my-panel
* Watch the `2021 Scylla Summit <https://www.scylladb.com/scylla-summit-2021/presentations/>`_ sessions on demand
* Watch a `tech-talk <https://www.scylladb.com/resources/tech-talks/>`_ on demand.
.. panel-box::
:title: Webinars
:id: "getting-started"
:class: my-panel
* Register for a `Webinar <https://www.scylladb.com/resources/webinars/>`_ or watch one on demand.