Convert html task description to md for most of Java Katas lessons

apache · pabloem · May 19, 2020 · Mar 24, 2020 · May 11, 2020 · May 16, 2020
commit d5606be2bbea63c69b1d4800e9963e5cbb65c766
diff --git a/.../Examples/Word Count/Word Count/task.html → ...va/Examples/Word Count/Word Count/task.md b/.../Examples/Word Count/Word Count/task.html → ...va/Examples/Word Count/Word Count/task.md
@@ -16,21 +16,18 @@
  ~ limitations under the License.
  -->
 
-<html>
-<h2>Word Count Pipeline</h2>
-<p>
- <b>Kata:</b> Create a pipeline that counts the number of words.
-</p>
-<p>
- Please output the count of each word in the following format:
-</p>
-<pre>
- word:count
- ball:5
- book:3
-</pre>
-<br>
+Word Count Pipeline
+-------------------
+
+**Kata:** Create a pipeline that counts the number of words.
+
+Please output the count of each word in the following format:
+```text
+word:count
+ball:5
+book:3
+```
+
 <div class="hint">
  Refer to your katas above.
 </div>
-</html>
diff --git a/...va/IO/Built-in IOs/Built-in IOs/task.html → ...java/IO/Built-in IOs/Built-in IOs/task.md b/...va/IO/Built-in IOs/Built-in IOs/task.html → ...java/IO/Built-in IOs/Built-in IOs/task.md
@@ -16,18 +16,14 @@
  ~ limitations under the License.
  -->
 
-<html>
-<h2>Built-in I/Os</h2>
-<p>
- Beam SDKs provide many out of the box I/O transforms that can be used to read from many
- different sources and write to many different sinks.
-</p>
-<p>
- See the <a href="https://beam.apache.org/documentation/io/built-in/">Beam-provided I/O
- Transforms</a> page for a list of the currently available I/O transforms.
-</p>
-<p>
- <b>Note:</b> There is no kata for this task. Please click the "Check" button and
- proceed to the next task.
-</p>
-</html>
+Built-in I/Os
+-------------
+
+Beam SDKs provide many out of the box I/O transforms that can be used to read from many different 
+sources and write to many different sinks.
+
+See the [Beam-provided I/O Transforms](https://beam.apache.org/documentation/io/built-in/) page for 
+a list of the currently available I/O transforms.
+
+**Note:** There is no kata for this task. Please click the "Check" button and proceed to the next 
+task.
diff --git a/...atas/java/IO/TextIO/TextIO Read/task.html → .../katas/java/IO/TextIO/TextIO Read/task.md b/...atas/java/IO/TextIO/TextIO Read/task.html → .../katas/java/IO/TextIO/TextIO Read/task.md
@@ -16,32 +16,29 @@
  ~ limitations under the License.
  -->
 
-<html>
-<h2>TextIO Read</h2>
-<p>
- When you create a pipeline, you often need to read data from some external source, such as a file
- or a database. Likewise, you may want your pipeline to output its result data to an external
- storage system. Beam provides read and write transforms for a number of common data storage types.
- If you want your pipeline to read from or write to a data storage format that isn’t supported by
- the built-in transforms, you can implement your own read and write transforms.
-</p>
-<p>
- To read a PCollection from one or more text files, use TextIO.read() to instantiate a transform
- and use TextIO.Read.from(String) to specify the path of the file(s) to be read.
-</p>
-<p>
- <b>Kata:</b> Read the 'countries.txt' file and convert each country name into uppercase.
-</p>
-<br>
+TextIO Read
+-----------
+
+When you create a pipeline, you often need to read data from some external source, such as a file 
+or a database. Likewise, you may want your pipeline to output its result data to an external 
+storage system. Beam provides read and write transforms for a number of common data storage types. 
+If you want your pipeline to read from or write to a data storage format that isn’t supported by 
+the built-in transforms, you can implement your own read and write transforms.
+
+To read a PCollection from one or more text files, use TextIO.read() to instantiate a transform 
+and use TextIO.Read.from(String) to specify the path of the file(s) to be read.
+
+**Kata:** Read the 'countries.txt' file and convert each country name into uppercase.
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/TextIO.html">
  TextIO</a> and its corresponding
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/io/TextIO.html#read--">
  TextIO.read()</a> method.
 </div>
+
 <div class="hint">
  Refer to the Beam Programming Guide
  <a href="https://beam.apache.org/documentation/programming-guide/#pipeline-io-reading-data">
  "Reading input data"</a> section for more information.
 </div>
-</html>
diff --git a/...roduction/Hello Beam/Hello Beam/task.html → ...ntroduction/Hello Beam/Hello Beam/task.md b/...roduction/Hello Beam/Hello Beam/task.html → ...ntroduction/Hello Beam/Hello Beam/task.md
@@ -16,38 +16,34 @@
  ~ limitations under the License.
  -->
 
-<html>
-<h2>Hello Beam Pipeline</h2>
-<p>
- Apache Beam is an open source, unified model for defining both batch and streaming data-parallel
- processing pipelines. Using one of the open source Beam SDKs, you build a program that defines the
- pipeline. The pipeline is then executed by one of Beam’s supported distributed processing
- back-ends, which include Apache Apex, Apache Flink, Apache Spark, and Google Cloud Dataflow.
-</p>
-<p>
- Beam is particularly useful for Embarrassingly Parallel data processing tasks, in which the
- problem can be decomposed into many smaller bundles of data that can be processed independently
- and in parallel. You can also use Beam for Extract, Transform, and Load (ETL) tasks and pure data
- integration. These tasks are useful for moving data between different storage media and data
- sources, transforming data into a more desirable format, or loading data onto a new system.
-</p>
-<p>
- To learn more about Apache Beam, refer to
- <a href="https://beam.apache.org/get-started/beam-overview/">Apache Beam Overview</a>.
-</p>
-<p>
- <b>Kata:</b> Your first kata is to create a simple pipeline that takes a hardcoded input element
- "Hello Beam".
-</p>
-<br>
+Welcome To Apache Beam
+----------------------
+
+Apache Beam is an open source, unified model for defining both batch and streaming data-parallel 
+processing pipelines. Using one of the open source Beam SDKs, you build a program that defines the 
+pipeline. The pipeline is then executed by one of Beam’s supported distributed processing back-ends,
+which include Apache Apex, Apache Flink, Apache Spark, and Google Cloud Dataflow.
+
+Beam is particularly useful for Embarrassingly Parallel data processing tasks, in which the problem 
+can be decomposed into many smaller bundles of data that can be processed independently and in 
+parallel. You can also use Beam for Extract, Transform, and Load (ETL) tasks and pure data 
+integration. These tasks are useful for moving data between different storage media and data 
+sources, transforming data into a more desirable format, or loading data onto a new system.
+
+To learn more about Apache Beam, refer to 
+[Apache Beam Overview](https://beam.apache.org/get-started/beam-overview/).
+
+**Kata:** Your first kata is to create a simple pipeline that takes a hardcoded input element 
+"Hello Beam".
+
 <div class="hint">
  Hardcoded input can be created using
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/Create.html">
  Create</a>.
 </div>
+
 <div class="hint">
  Refer to the Beam Programming Guide
  <a href="https://beam.apache.org/documentation/programming-guide/#creating-pcollection-in-memory">
  "Creating a PCollection from in-memory data"</a> section for more information.
 </div>
-</html>
diff --git a/...s/Early Triggers/Early Triggers/task.html → ...ers/Early Triggers/Early Triggers/task.md b/...s/Early Triggers/Early Triggers/task.html → ...ers/Early Triggers/Early Triggers/task.md
@@ -16,44 +16,45 @@
  ~ limitations under the License.
  -->
 
-<html>
-<h2>Early Triggers</h2>
-<p>
- Triggers allow Beam to emit early results, before all the data in a given window has arrived.
- For example, emitting after a certain amount of time elapses, or after a certain number of
- elements arrives.
-</p>
-<p>
- <b>Kata:</b> Given that events are being generated every second and a fixed window of 1-day
- duration, please implement an early trigger that emits the number of events count immediately
- after new element is processed.
-</p>
-<br>
+Early Triggers
+--------------
+
+Triggers allow Beam to emit early results, before all the data in a given window has arrived. For 
+example, emitting after a certain amount of time elapses, or after a certain number of elements 
+arrives.
+
+**Kata:** Given that events are being generated every second and a fixed window of 1-day duration, 
+please implement an early trigger that emits the number of events count immediately after new 
+element is processed.
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/AfterWatermark.AfterWatermarkEarlyAndLate.html#withEarlyFirings-org.apache.beam.sdk.transforms.windowing.Trigger.OnceTrigger-">
  withEarlyFirings</a> to set early firing triggers.
 </div>
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/FixedWindows.html">
  FixedWindows</a> with 1-day duration using
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/AfterWatermark.html#pastEndOfWindow--">
  AfterWatermark.pastEndOfWindow()</a> trigger.
 </div>
+
 <div class="hint">
  Set the <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/Window.html#withAllowedLateness-org.joda.time.Duration-">
  allowed lateness</a> to 0 with
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/Window.html#discardingFiredPanes--">
  discarding accumulation mode</a>.
 </div>
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/Combine.html#globally-org.apache.beam.sdk.transforms.CombineFnBase.GlobalCombineFn-">
  Combine.globally</a> and
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/Count.html#combineFn--">
  Count.combineFn</a> to calculate the count of events.
 </div>
+
 <div class="hint">
  Refer to the Beam Programming Guide
  <a href="https://beam.apache.org/documentation/programming-guide/#event-time-triggers">
  "Event time triggers"</a> section for more information.
 </div>
-</html>
diff --git a/...me Triggers/Event Time Triggers/task.html → ...Time Triggers/Event Time Triggers/task.md b/...me Triggers/Event Time Triggers/task.html → ...Time Triggers/Event Time Triggers/task.md
@@ -16,63 +16,57 @@
  ~ limitations under the License.
  -->
 
-<html>
-<h2>Event Time Triggers</h2>
-<p>
- When collecting and grouping data into windows, Beam uses triggers to determine when to emit the
- aggregated results of each window (referred to as a pane). If you use Beam’s default windowing
- configuration and default trigger, Beam outputs the aggregated result when it estimates all data
- has arrived, and discards all subsequent data for that window.
-</p>
-<p>
- You can set triggers for your PCollections to change this default behavior. Beam provides a
- number of pre-built triggers that you can set:
-</p>
-<div>
- <ul>
- <li>Event time triggers</li>
- <li>Processing time triggers</li>
- <li>Data-driven triggers</li>
- <li>Composite triggers</li>
- </ul>
-</div>
-<p>
- Event time triggers operate on the event time, as indicated by the timestamp on each data
- element. Beam’s default trigger is event time-based.
-</p>
-<p>
- The AfterWatermark trigger operates on event time. The AfterWatermark trigger emits the contents
- of a window after the watermark passes the end of the window, based on the timestamps attached
- to the data elements. The watermark is a global progress metric, and is Beam’s notion of input
- completeness within your pipeline at any given point. AfterWatermark.pastEndOfWindow() only fires
- when the watermark passes the end of the window.
-</p>
-<p>
- <b>Kata:</b> Given that events are being generated every second, please implement a trigger that
- emits the number of events count within a fixed window of 5-second duration.
-</p>
-<br>
+Event Time Triggers
+-------------------
+
+When collecting and grouping data into windows, Beam uses triggers to determine when to emit the 
+aggregated results of each window (referred to as a pane). If you use Beam’s default windowing 
+configuration and default trigger, Beam outputs the aggregated result when it estimates all data 
+has arrived, and discards all subsequent data for that window.
+
+You can set triggers for your PCollections to change this default behavior. Beam provides a number 
+of pre-built triggers that you can set:
+
+* Event time triggers
+* Processing time triggers
+* Data-driven triggers
+* Composite triggers
+
+Event time triggers operate on the event time, as indicated by the timestamp on each data element. 
+Beam’s default trigger is event time-based.
+
+The AfterWatermark trigger operates on event time. The AfterWatermark trigger emits the contents 
+of a window after the watermark passes the end of the window, based on the timestamps attached to 
+the data elements. The watermark is a global progress metric, and is Beam’s notion of input 
+completeness within your pipeline at any given point. AfterWatermark.pastEndOfWindow() only fires 
+when the watermark passes the end of the window.
+
+**Kata:** Given that events are being generated every second, please implement a trigger that emits 
+the number of events count within a fixed window of 5-second duration.
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/FixedWindows.html">
  FixedWindows</a> with 5-second duration using
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/AfterWatermark.html#pastEndOfWindow--">
  AfterWatermark.pastEndOfWindow()</a> trigger.
 </div>
+
 <div class="hint">
  Set the <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/Window.html#withAllowedLateness-org.joda.time.Duration-">
  allowed lateness</a> to 0 with
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/Window.html#discardingFiredPanes--">
  discarding accumulation mode</a>.
 </div>
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/Combine.html#globally-org.apache.beam.sdk.transforms.CombineFnBase.GlobalCombineFn-">
  Combine.globally</a> and
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/Count.html#combineFn--">
  Count.combineFn</a> to calculate the count of events.
 </div>
+
 <div class="hint">
  Refer to the Beam Programming Guide
  <a href="https://beam.apache.org/documentation/programming-guide/#event-time-triggers">
  "Event time triggers"</a> section for more information.
 </div>
-</html>
diff --git a/...n Mode/Window Accumulation Mode/task.html → ...ion Mode/Window Accumulation Mode/task.md b/...n Mode/Window Accumulation Mode/task.html → ...ion Mode/Window Accumulation Mode/task.md
@@ -16,48 +16,50 @@
  ~ limitations under the License.
  -->
 
-<html>
-<h2>Window Accumulation Mode</h2>
-<p>
- When you specify a trigger, you must also set the the window’s accumulation mode. When a trigger
- fires, it emits the current contents of the window as a pane. Since a trigger can fire multiple
- times, the accumulation mode determines whether the system accumulates the window panes as the
- trigger fires, or discards them.
-</p>
-<p>
- <b>Kata:</b> Given that events are being generated every second and a fixed window of 1-day
- duration, please implement an early trigger that emits the number of events count immediately
- after new element is processed in accumulating mode.
-</p>
-<br>
+Window Accumulation Mode
+------------------------
+
+When you specify a trigger, you must also set the the window’s accumulation mode. When a trigger 
+fires, it emits the current contents of the window as a pane. Since a trigger can fire multiple 
+times, the accumulation mode determines whether the system accumulates the window panes as the 
+trigger fires, or discards them.
+
+**Kata:** Given that events are being generated every second and a fixed window of 1-day duration, 
+please implement an early trigger that emits the number of events count immediately after new 
+element is processed in accumulating mode.
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/2.13.0/org/apache/beam/sdk/transforms/windowing/Window.html#accumulatingFiredPanes--">
  accumulatingFiredPanes()</a> to set a window to accumulate the panes that are produced when the
  trigger fires.
 </div>
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/AfterWatermark.AfterWatermarkEarlyAndLate.html#withEarlyFirings-org.apache.beam.sdk.transforms.windowing.Trigger.OnceTrigger-">
  withEarlyFirings</a> to set early firing triggers.
 </div>
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/FixedWindows.html">
  FixedWindows</a> with 1-day duration using
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/AfterWatermark.html#pastEndOfWindow--">
  AfterWatermark.pastEndOfWindow()</a> trigger.
 </div>
+
 <div class="hint">
  Set the <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/windowing/Window.html#withAllowedLateness-org.joda.time.Duration-">
  allowed lateness</a> to 0.
 </div>
+
 <div class="hint">
  Use <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/Combine.html#globally-org.apache.beam.sdk.transforms.CombineFnBase.GlobalCombineFn-">
  Combine.globally</a> and
  <a href="https://beam.apache.org/releases/javadoc/current/org/apache/beam/sdk/transforms/Count.html#combineFn--">
  Count.combineFn</a> to calculate the count of events.
 </div>
+
 <div class="hint">
  Refer to the Beam Programming Guide
  <a href="https://beam.apache.org/documentation/programming-guide/#event-time-triggers">
  "Event time triggers"</a> section for more information.
 </div>
-</html>