From a128c05a97b98e6a243060665a1e53fa7a4b79a4 Mon Sep 17 00:00:00 2001
From: Dag <me@dvikan.no>
Date: Tue, 5 Aug 2025 21:06:40 +0200
Subject: [PATCH] docs: emphasize strict types (#4657)

---
 README.md                                     | 12 +++-
 .../01_How_to_create_a_new_bridge.md          | 55 ++++++++++---------
 2 files changed, 41 insertions(+), 26 deletions(-)

diff --git a/README.md b/README.md
index 66d9b46e..7e155db7 100644
--- a/README.md
+++ b/README.md
@@ -321,13 +321,23 @@ The sqlite files (db, wal and shm) are not writeable.
 
     rm cache/*
 
-### How to create a new bridge from scratch
+### How to create a completely new bridge
+
+New code files MUST have `declare(strict_types=1);` at the top of file:
+
+```php
+<?php
+
+declare(strict_types=1);
+```
 
 Create the new bridge in e.g. `bridges/BearBlogBridge.php`:
 
 ```php
 <?php
 
+declare(strict_types=1);
+
 class BearBlogBridge extends BridgeAbstract
 {
     const NAME = 'BearBlog (bearblog.dev)';
diff --git a/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md b/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
index 02287962..e7d401dd 100644
--- a/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
+++ b/docs/05_Bridge_API/01_How_to_create_a_new_bridge.md
@@ -1,31 +1,36 @@
-Create a new file in the `bridges/` folder (see [Folder structure](../04_For_Developers/03_Folder_structure.md)).
+# How to create a completely new bridge
 
-The file name must be named according to following specification:
-* It starts with the full name of the site
-* All white-space must be removed
-* The first letter of a word is written in upper-case, unless the site name is specified otherwise (example: Freenews, not FreeNews, because the site is named 'Freenews')
-* The first character must be upper-case
-* The file name must end with 'Bridge'
-* The file type must be PHP, written in **small** letters (seriously!) ".php"
-
-**Examples:**
-
-Site | Filename
------|---------
-Wikipedia | **Wikipedia**Bridge.php
-Facebook | **Facebook**Bridge.php
-GitHub | **GitHub**Bridge.php
-Freenews | **Freenews**Bridge.php
-
-The file must start with the PHP tags and end with an empty line. The closing tag `?>` is [omitted](http://php.net/basic-syntax.instruction-separation). 
-
-**Example:**
+New code files MUST have `declare(strict_types=1);` at the top of file:
 
 ```php
 <?php
-	// PHP code here
-// This line is empty (just imagine it!)
+
+declare(strict_types=1);
 ```
 
-The next step is to extend one of the base classes.
-Refer to one of an base classes listed on the [Bridge API](../05_Bridge_API/index.md) page.
+Create the new bridge in e.g. `bridges/BearBlogBridge.php`:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+class BearBlogBridge extends BridgeAbstract
+{
+    const NAME = 'BearBlog (bearblog.dev)';
+
+    public function collectData()
+    {
+        $dom = getSimpleHTMLDOM('https://herman.bearblog.dev/blog/');
+        foreach ($dom->find('.blog-posts li') as $li) {
+            $a = $li->find('a', 0);
+            $this->items[] = [
+                'title' => $a->plaintext,
+                'uri' => 'https://herman.bearblog.dev' . $a->href,
+            ];
+        }
+    }
+}
+```
+
+Learn more in [bridge api](https://rss-bridge.github.io/rss-bridge/Bridge_API/index.html).