Add quickstart document and relevant example

Changes

@@ -2,6 +2,10 @@ Revision history for OpenTelemetry
 
 {{$NEXT}}
 
+    * Added OpenTelemetry::Guides::Quickstart and its related
+      examples. More practical documentation will also occupy
+      that namespace.
+
 0.025     2024-10-20 13:50:19+01:00 Europe/London
 
     * Fixed an issue in the integrations for HTTP::Tiny and

examples/guides/quickstart/.gitignore

@@ -0,0 +1 @@
+local/

examples/guides/quickstart/Dice

@@ -0,0 +1,11 @@
+#!/usr/bin/env perl
+use Mojolicious::Lite -signatures;
+
+use OpenTelemetry::SDK;
+plugin 'OpenTelemetry';
+
+get '/roll' => sub ($c) {
+  $c->render( json => int 1 + rand 6 );
+};
+
+app->start;

examples/guides/quickstart/Dockerfile

@@ -0,0 +1,7 @@
+FROM perl:5.40
+
+WORKDIR /app
+ADD cpanfile cpanfile.snapshot ./
+RUN cpm install --local-lib-contained=/root/.local Carton::Snapshot \
+ && PERL5OPT="-I/root/.local/lib/perl5" cpm install --global \
+ && rm -rf cpanfile cpanfile.snapshot /root/.local

examples/guides/quickstart/cpanfile

@@ -0,0 +1,4 @@
+requires 'Mojolicious';
+requires 'Mojolicious::Plugin::OpenTelemetry';
+requires 'OpenTelemetry';
+requires 'OpenTelemetry::SDK';