docs: Add Motoko footer image (#4640)

* fix links

* add footer image

* add footer image

doc/md/canister-maintenance/compatibility.md

@@ -184,4 +184,6 @@ Motoko embeds `.did` and `.most` files as Wasm custom sections for use by other
 
 ```
 let msg = format!("Candid interface compatibility check failed for canister '{}'.\nYou are making a BREAKING change. Other canisters or frontend clients relying on your canister may stop working.\n\n", canister_info.get_name()) + &err;
-```
+```
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/canister-maintenance/cycles.md

@@ -106,3 +106,6 @@ For this example, Alice is using her readily available cycles that she already o
 Because `porky` consumes cycles in its operation, it is possible for `porky` to spend some or even all of Alice’s cycle savings before she has a chance to retrieve them.
 
 :::
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />
+

doc/md/canister-maintenance/optimization.md

@@ -59,3 +59,6 @@ Note that in certain cases the optimizations can increase the complexity of cert
 :::
 
 More information on canister optimization and information on `wasm-opt` benchmark testing can be found [on this forum post](https://forum.dfinity.org/t/canister-optimizer-available-in-dfx-0-14-0/21157).
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/canister-maintenance/upgrades.md

@@ -198,3 +198,5 @@ After you have deployed a Motoko actor with the appropriate `stable` variables o
 ```
 let msg = format!("Candid interface compatibility check failed for canister '{}'.\nYou are making a BREAKING change. Other canisters or frontend clients relying on your canister may stop working.\n\n", canister_info.get_name()) + &err;
 ```
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/getting-started/basic-concepts.md

@@ -205,3 +205,5 @@ assert n % 2 == 0; // traps when n not even
 ```
 
 Because an assertion may succeed, and thus proceed with execution, it may only be used in context where a value of type `()` is expected.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/getting-started/dev-env.md

@@ -142,3 +142,5 @@ Here is an example `dfx.json` canister configuration that uses `args`:
   }
 ...
 ```
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/getting-started/examples.md

@@ -108,3 +108,5 @@ Want to get started building with Motoko? Check out some of these sample project
 - [Motoko book](https://github.com/Web3NL/motoko-book): An educational book on Motoko.
 
 - [Motoko Bootcamp](https://github.com/motoko-bootcamp/education): Lessons and lectures on Motoko development.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/getting-started/motoko-introduction.md

@@ -94,3 +94,5 @@ For scenarios that can’t be solved using stable variables alone, Motoko provid
 ## Getting started
 
 Get started with Motoko by [setting up your developer environment](dev-env.md) and creating a simple [Hello, world!](quickstart.md) program.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/getting-started/quickstart.md

@@ -104,3 +104,5 @@ Frontend canister via browser
 Backend canister via Candid interface:
         access_hello_backend: http://127.0.0.1:4943/?canisterId=cbopz-duaaa-aaaaa-qaaka-cai&id=ctiya-peaaa-aaaaa-qaaja-cai
 ```
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/migration-guides/0.11.0-migration-guide.md

@@ -80,4 +80,6 @@ System capability is available within the following contexts:
 - Within the body of a local (i.e. not `shared`) function or class that is declared with `system` pseudo-type parameter.
 - Within the system functions `preupgrade` and `postupgrade`.
 
-No other context provides system capabilities, including the bodies of query and composite query methods.
+No other context provides system capabilities, including the bodies of query and composite query methods.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/migration-guides/overview.md

@@ -8,4 +8,6 @@ New versions of Motoko may introduce breaking changes that are not backwards com
 
 ## Migration guides
 
-- [0.11.0 Migration guide](0.11.0-migration-guide.md)
+- [0.11.0 Migration guide](0.11.0-migration-guide.md)
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-packages/cryptography.md

@@ -20,4 +20,6 @@ sidebar_position: 1
 
 - [`sha2`](https://mops.one/sha2): An optimized implementation of all SHA2 functions.
 
-- [`sha3`](https://mops.one/sha3): A Motoko SHA3/Keccak library.
+- [`sha3`](https://mops.one/sha3): A Motoko SHA3/Keccak library.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-packages/data-structures.md

@@ -45,3 +45,6 @@ sidebar_position: 2
 - [`swbstable`](https://mops.one/swbstable): Stable sliding window buffer with random access.
 
 - [`vector`](https://mops.one/vector): Memory-efficient resizable array. Can be used as a replacement for `Buffer`.
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-packages/databases.md

@@ -19,3 +19,5 @@ sidebar_position: 3
 - [`nacdb-reorder`](https://mops.one/nacdb-reorder): Re-orderable lists in NacDB database.
 
 - [`rxmodb`](https://mops.one/rxmodb): Motoko databases using `Vector` for main storage and `BTree` for indexes.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-packages/encoding.md

@@ -22,4 +22,6 @@ sidebar_position: 4
 
 - [`serde`](https://mops.one/serde): Serialization and deserialization.
 
-- [`xml`](https://mops.one/xml): Encode and decode XML.
+- [`xml`](https://mops.one/xml): Encode and decode XML.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-packages/http.md

@@ -32,4 +32,6 @@ sidebar_position: 5
 
 - [`server`](https://mops.one/server): A server for Motoko similar to Express.
 
-- [`web-api`](https://mops.one/web-api) and [`web-io`](https://mops.one/web-io): Create HTTP requests and handle responses.
+- [`web-api`](https://mops.one/web-api) and [`web-io`](https://mops.one/web-io): Create HTTP requests and handle responses.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-packages/icrc.md

@@ -38,4 +38,6 @@ sidebar_position: 5
 
 - [`icrc-nft-mo`](https://mops.one/icrc-nft-mo): An ICRC NFT library.
 
-- [`origyn-nft`](https://mops.one/origyn-nft): The reference implementation for the ORIGYN NFT.
+- [`origyn-nft`](https://mops.one/origyn-nft): The reference implementation for the ORIGYN NFT.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-packages/types-interfaces.md

@@ -35,5 +35,6 @@ sidebar_position: 6
 - [`xrc-types`](https://mops.one/xrc-types): Exchange rate canister interface.
 
 
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />
 
 

doc/md/motoko-packages/utilities.md

@@ -57,3 +57,4 @@ sidebar_position: 7
 - [`xtended-text`](https://mops.one/xtended-text): Text manipulation.
 
 
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-tools/embed-motoko.md

@@ -42,3 +42,4 @@ The console output on the page will confirm that the iframe code has been copied
 
 
 
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-tools/mo-dev.md

@@ -94,3 +94,6 @@ The [Vite + React + Motoko](https://github.com/rvanasa/vite-react-motoko#readme)
 ## Important notes
 
 `mo-dev` is early in development. Please feel free to report a bug, ask a question, or request a feature on the project's [GitHub issues](https://github.com/dfinity/motoko-dev-server/issues) page. 
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-tools/motoko-formatter.md

@@ -79,3 +79,5 @@ mo-fmt -c **/*
 - [Motoko extension for VS Code](https://marketplace.visualstudio.com/items?itemName=dfinity-foundation.vscode-motoko)
 
 - [`mo-fmt`](https://www.npmjs.com/package/mo-fmt)
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/motoko-tools/motoko-js.md

@@ -88,3 +88,6 @@ service : {
 - [Top level API](https://github.com/dfinity/node-motoko?tab=readme-ov-file#top-level-api)
 
 - [File API](https://github.com/dfinity/node-motoko?tab=readme-ov-file#file-api)
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/reference/compiler-ref.md

@@ -68,3 +68,6 @@ You can use the following options with the `moc` command.
 | `-v`                                      | Generates verbose output.
 | `--version`                               | Displays version information.                                                                                                                         |
 | `-wasi-system-api`                        | Uses the WASI system API (`wasmtime`).                                                                                                                |
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/reference/error-codes.md

@@ -54,4 +54,7 @@ sidebar_position: 6
 | M0194      | An identifier was defined without referencing it later. |
 | M0195      | A function that demands elevated (system) capabilities was called without manifestly passing the capability. |
 | M0197      | A function that requires (system) capabilities was called in a context that does not provide them. |
-| M0198      | A field identifier was specified in an object pattern without referencing this identifier later. |
+| M0198      | A field identifier was specified in an object pattern without referencing this identifier later. |
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/reference/generating-docs.md

@@ -73,4 +73,6 @@ func factorial(n : Nat) : ?Nat {
 ## Resources
 Check out Motoko's [base library source code](https://github.com/dfinity/motoko-base/tree/master/src) for additional examples and best practices. 
 
-The source code for `mo-doc` is available in the [dfinity/motoko](https://github.com/dfinity/motoko/tree/master/src/docs) GitHub repository. Contributions are welcome!
+The source code for `mo-doc` is available in the [dfinity/motoko](https://github.com/dfinity/motoko/tree/master/src/docs) GitHub repository. Contributions are welcome!
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/reference/language-manual.md

@@ -2694,3 +2694,6 @@ In general, this means that an expression of a more specific type may appear whe
 ## References
 
 -   **IEEE Standard for Floating-Point Arithmetic**, in IEEE Std 754-2019 (Revision of IEEE 754-2008), vol., no., pp.1-84, 22 July 2019, doi: 10.1109/IEEESTD.2019.8766229.
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/reference/motoko-grammar.md

@@ -8,3 +8,6 @@ This section describes the concrete syntax, or grammar, of Motoko. The specifica
 
 ``` bnf file=../examples/grammar.txt
 ```
+
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/reference/style.md

@@ -896,3 +896,5 @@ Rationale: `g[1]` in particular will be misparsed as an indexing operation.
 <!--
 === To be extended
 -->
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/stable-memory/stable-regions.md

@@ -102,4 +102,6 @@ The shared `get(index)` query reads anywhere from the log without traversing any
 
 - [`stable-enum`](https://mops.one/stable-enum): Enumerations implemented in stable regions.
 
-- [`stable-buffer`](https://mops.one/stable-buffer): Buffers implemented in stable regions.
+- [`stable-buffer`](https://mops.one/stable-buffer): Buffers implemented in stable regions.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/stable-memory/stablememory.md

@@ -31,3 +31,5 @@ New applications should use the `Region` library: it offers additional isolation
 - [motoko-dht](https://github.com/enzoh/motoko-dht): A distributed hash table sample.
 
 - [motoko-document-db](https://github.com/DepartureLabsIC/motoko-document-db): A document database sample.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/actor-classes.md

@@ -84,3 +84,4 @@ lower-level facilities of the Internet Computer.
 
 See [actor class management](../reference/language-manual#actor-class-management) for more details.
 
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/actors-async.md

@@ -151,3 +151,5 @@ Consider the following stateful `Atomicity` actor:
 Calling the shared function `atomic()` will fail with an error, since the last statement causes a trap. However, the trap leaves the mutable variable `s` with value `0`, not `1`, and variable `pinged` with value `false`, not `true`. This is because the trap happens before the method `atomic` has executed an `await`, or exited with a result. Even though `atomic` calls `ping()`, `ping()` is queued until the next commit point.
 
 Calling the shared function `nonAtomic()` will also fail with an error due to a trap. In this function, the trap leaves the variable `s` with value `3`, not `0`, and variable `pinged` with value `true`, not `false`. This is because each `await` commits its preceding side-effects, including message sends. Even though `f` is complete by the second await, this await also forces a commit of the state, suspends execution and allows for interleaved processing of other messages to this actor.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/arguments.md

@@ -61,3 +61,5 @@ dfx canister call favorite_cities location '(vec {"San Francisco";"Paris";"Rome"
 ```
 
 The command uses the Candid interface description syntax `(vec { val1; val2; val3; })` to return a vector of values. For more information about the Candid interface description language, see the [Candid](https://internetcomputer.org/docs/current/developer-docs/smart-contracts/candid/candid-concepts) language guide.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/async-data.md

@@ -94,3 +94,4 @@ Each `await` suspends execution, allowing an interloper to change the state of t
 
 - [`star`](https://mops.one/star): Used for handling asynchronous behavior and traps using async* functions.
 
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/caller-id.md

@@ -55,3 +55,5 @@ Simple actor declarations do not let you access their installer. If you need acc
 :::
 
 Principals support equality, ordering, and hashing, so you can efficiently store principals in containers for functions such as maintaining an allow or deny list. More operations on principals are available in the [principal](../base/Principal.md) base library.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/candid-ui.md

@@ -25,3 +25,5 @@ To learn how to use Candid, check out the documentation here:
 - [Using Candid](/docs/current/developer-docs/smart-contracts/candid/candid-howto).
 
 - [Candid specification](https://github.com/dfinity/candid/blob/master/spec/Candid.md).
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/control-flow.md

@@ -202,3 +202,5 @@ Many built-in data structures come with pre-defined iterators. Below table lists
 
 
 User-defined data structures can define their own iterators. As long they conform with the `Iter<A>` type for some element type `A`, these behave like the built-in ones and can be consumed with ordinary `for`-loops.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/errors.md

@@ -134,3 +134,5 @@ Callsite:
 
 ``` motoko no-repl file=../examples/todo-error.mo#L108-L115
 ```
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/heartbeats.md

@@ -20,3 +20,5 @@ A simple, contrived example is a recurrent alarm, that sends a message to itself
 The `heartbeat` function is called on every ICP subnet heartbeat by scheduling an asynchronous call to the `heartbeat` function. Due to its `async` return type, a heartbeat function may send further messages and await results. The result of a heartbeat call, including any trap or thrown error, is ignored. The implicit context switch inherent to calling every Motoko async function means that the time the `heartbeat` body is executed may be later than the time the heartbeat was issued by the subnet.
 
 As an `async` function, `Alarm`'s `heartbeat` function is free to call other asynchronous functions, as well as shared functions of other canisters.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/incomplete-code.md

@@ -45,4 +45,6 @@ To document unreachable code, you can use the  `unreachable` function from the p
 P.unreachable()
 ```
 
-Like `unreachable()` has type `None` and thus any other type, and will trap on (unexpected!) execution.
+Like `unreachable()` has type `None` and thus any other type, and will trap on (unexpected!) execution.
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/integers.md

@@ -79,3 +79,4 @@ This program supports the following function calls:
 
 -   The `clearall` function clears the `cell` value stored as the result of previous operations, resetting the `cell` value to zero.
 
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/intercanister-calls.md

@@ -71,3 +71,5 @@ Then, use the following call, replacing `canisterID` with the principal ID of a
 ```
 dfx canister call canister1 main "canisterID"
 ```
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/local-objects-classes.md

@@ -323,3 +323,5 @@ This syntax provides a convenient way to create modular and reusable code in Mot
 extend existing objects with new functionality.
 
 For more details, see the [language manual](../reference/language-manual#object-combinationextension).
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />

doc/md/writing-motoko/message-inspection.md

@@ -118,4 +118,6 @@ instead of expected type
         #set : () -> Nat
       }
   } -> Bool
-```
+```
+
+<img src="https://github.com/user-attachments/assets/844ca364-4d71-42b3-aaec-4a6c3509ee2e" alt="Logo" width="150" height="150" />