Merge pull request #6 from datastax/develop

Merge dev into main

Author: mendonk

.DS_Store

@@ -0,0 +1,14 @@
+= streaming-learning-docs
+
+== Writing a guide
+
+A guide is a document offering step by step instruction to reach some goal. Guides are technical in nature and tend to make assumptions about the consumer's environment. To help create guides that will work in most environments, please follow these ideas.
+
+* *Keep links to a minimum* - when someone is learning a new concept for the first time and xref:README.adoc[every] other xref:README.adoc[word] is linked it xref:README.adoc[makes] things xref:README.adoc[confusing] and hard to get a good flow going. Instead, annotate a word or phrase and provide a "Resources" area at the bottom of the guide.
+* *Separate products and runtimes in tabs* - it is common to reach the same result through multiple ways. An example is creating a tenant/namespace/topic in Astra Streaming and Luna Streaming. Both have the same result but get there in very different ways. Offer each as a tab and let the consumer choose their path. The step after the tabbed step can assume the consumer has complete the previious step and is in a known state. Runtimes follow the same pattern. Weather one is using Java or C#, they are still creating a Pulsar client to interact with the cluster. Create a single step in the guide with multiple tabs for each runtime.
+* *Be thoughtful about the names you use* - if you are leaning a new concept or feature with no background on the product, words matter. Labeling a tab as "Luna Helm" and then referring to it as "Pulsar Helm Chart" are two distinct things to that reader. The author of the document has such deep understanding that they consider those things the same - and technically they are at DataStax. But the read isn't from DataStax, so be mindful of their context.
+* *Talk in first person* - humans create the guides and humans consume the guides. Write as if you are paired with your consumer in doing what ever the guide does. Use "we", "us", "you".
+
+=== Starter example
+
+Create a new .adoc file in the appropriate module and use the `example-guide.adoc` file as a starting point to creating a new guide.

README.adoc

@@ -0,0 +1,16 @@
+name: streaming-learning
+title: Streaming Learning
+version: ~
+start_page: index.adoc
+
+asciidoc:
+  attributes:
+    product_name: 'Astra Streaming'
+    pulsar_version: '2.10' #DO NOT INCLUDE PATCH VERSION <MAJOR>.<MINOR>.<PATCH>
+    debezium_version: '1.7'
+    request_feature_access_email: '[email protected]'
+    astra_ui: 'Astra Portal'
+
+nav:
+- modules/pulsar-io/nav.adoc
+- modules/functions/nav.adoc

README.md

@@ -0,0 +1,72 @@
+= Use this new feature
+:navtitle: Create a feature
+:description: This guide will take you step-by-step through implementing this new feature
+:title: A guide to creating a new feature
+
+Have you ever wanted to use this new feature? Well look no further than this guide to get started. We will be implementing it from scratch and you will find a set of links at the bottom to continue use of the feature.
+
+== Pre-req's
+
+You will need the following things in place to complete this guide:
+
+* about 5 minutes
+* a working Pulsar topic (xref:README.adoc[get started here] if you don't have one)
+
+== First group of tasks
+
+This is the first group of tasks[<<resource-1>>] that need to be complete before moving on to the next group. Each group provides simple starting/stopping points for the consumer as well as a good summary of whats needed to create the new feature.
+
+. Do this
+. Then this
+.. You'll need to do this during this step
+.. And also this
+. Then this after that
+
+== Second group of tasks
+
+This is the next group of tasks[<<resource-2>>]. You get the point of task groupings.
+
+. This step can be done in different runtimes and uses tabs
+
+[tabs]
+====
+C#::
++
+--
+[source,csharp]
+----
+var a = new Something();
+Console.Write(a.thing);
+----
+--
+Java::
++
+--
+[source,java]
+----
+class aa{
+  public aa(){}
+  public String doSomething(){
+    return "a string";
+  }
+}
+----
+--
+====
+
+== Summary
+
+In this guide we created a new feature and did the basics of interacting. Now it's time to extend the feature and become a ninja!
+
+== Resources
+
+[[resource-1,1]] xref:README.adoc[Some resource talked about in the guide]
+
+[[resource-2,2]] xref:README.adoc[Another resource talked about in the guide]
+
+== Next steps
+
+Here are links to other guides you might be interested in:
+
+* Something
+* Something else

antora.yml

@@ -0,0 +1,3 @@
+= DataStax Streaming Learning
+
+The learning site is a collection of guides and articles about DataStax streaming products. Each product has its own area dedicated to providing specifics to get started, its features, and other details. The learning site helps you get the most out of each product and get to production using best practices.