Add llms.txt and update home samples.

Author: jcamiel

sites/build_home_samples.py

@@ -15,7 +15,7 @@ def __init__(self, name: str, src: str):
         src_padding = src
         # Count number of line in src, add padding if necessary
         nl = src_padding.count("\n")
-        max_line = 12
+        max_line = 14
         if nl < max_line:
             src_padding += "\n" * (max_line - nl)
         self.src = src_padding
@@ -85,6 +85,7 @@ def make_home_samples():
         Sample(
             name="Form",
             src="""\
+# Sending form data
 POST https://example.org/contact
 [Form]
 default: false
@@ -124,23 +125,27 @@ def make_home_samples():
         Sample(
             name="Capture Data",
             src="""\
-# Get home:
+# Go home and capture token
 GET https://example.org
 HTTP 200
 [Captures]
 csrf_token: xpath "string(//meta[@name='_csrf_token']/@content)"
 
 
 # Do login!
-POST https://example.org/login?user=toto&password=1234
+POST https://example.org/login
 X-CSRF-TOKEN: {{csrf_token}}
+[Form]
+user: toto
+password: 1234
 HTTP 302
 """,
         ),
         Sample(
             name="JSON Body",
             src="""\
-# Create a new doggy thing with JSON body:
+# Create a new doggy thing with JSON body.
+# JSON body can be inlined:
 POST https://example.org/api/dogs
 {
     "id": 0,
@@ -155,6 +160,7 @@ def make_home_samples():
         Sample(
             name="SOAP / XML Body",
             src="""\
+# Like JSON body, XML bidy can be inlined to use SOAP APIs:
 POST https://example.org/InStock
 Content-Type: application/soap+xml; charset=utf-8
 SOAPAction: "http://www.w3.org/2003/05/soap-envelope"

sites/hurl.dev/_includes/top-nav.html

@@ -24,7 +24,7 @@
                 <div class="top-nav-link u-d-block-md">
                     <a class="top-nav-link-a" href="https://github.com/Orange-OpenSource/hurl" alt="GitHub">
                         <span class="svg-icon"><svg viewBox="0 0 496 512" width="18" height="18"><use href="#github"></use></svg>&nbsp;</span>
-                        <span class="u-underline">GitHub</span><span class="github">★14k</span>
+                        <span class="u-underline">GitHub</span><span class="github">★16k</span>
                     </a>
                 </div>
                 <div class="top-nav-link u-d-block-md">

sites/hurl.dev/humans.txt

@@ -13,7 +13,7 @@ A simple sample with multiple requests:
     # ------------------------------------
 
     POST https://example.net/api/contacts
-    [FormParams]
+    [Form]
     token: {{token}}
     email: toto@rookie.net
     HTTP 201