diff --git a/front/views/DisplayResults.tsx b/front/views/DisplayResults.tsx
index c9c7ed1..355466c 100644
--- a/front/views/DisplayResults.tsx
+++ b/front/views/DisplayResults.tsx
@@ -2,7 +2,7 @@ import ReactDOM from "react-dom/client";
 import React from "react";
 
 
-function DisplayResults({username, password}: any) {
+function DisplayResults({password, username}: any) {
     return (
         <div>
             <p>username: {username}</p>
diff --git a/src/Controller/SampleFormController.php b/src/Controller/SampleFormController.php
index 3e7fe40..8a4faa7 100644
--- a/src/Controller/SampleFormController.php
+++ b/src/Controller/SampleFormController.php
@@ -6,10 +6,10 @@ require_once "react-display.php";
 
 class SampleFormController {
     public function displayForm() {
-        display_react_front("views/SampleForm.tsx", []);
+        send_react_front("views/SampleForm.tsx", []);
     }
 
     public function displayResults(array $request) {
-        display_react_front("views/DisplayResults.tsx", $request);
+        send_react_front("views/DisplayResults.tsx", $request);
     }
 }
\ No newline at end of file
diff --git a/src/react-display-file.php b/src/react-display-file.php
index 9f69280..a2da050 100755
--- a/src/react-display-file.php
+++ b/src/react-display-file.php
@@ -13,6 +13,14 @@
     <title>Document</title>
 </head>
 <body id="root">
+
+<!--
+here's the magic.
+imports the given view URL, and assume that the view exports a function named `render` that
+takes exactly one object argument.
+If the imported file does not export a function with signature `render(arguments: any)`,
+the call wont work thus the view will not be displayed
+-->
 <script type="module">
     import {render} from "<?= asset($url) ?>"
     render(<?= json_encode($arguments) ?>)
diff --git a/src/react-display.php b/src/react-display.php
index b4c6f1e..b965a3a 100644
--- a/src/react-display.php
+++ b/src/react-display.php
@@ -1,12 +1,13 @@
 <?php
 
 /**
- * sends a react view to the user.
+ * sends a react view to the user client.
  * @param string $url url of the react file to render
  * @param array $arguments arguments to pass to the rendered react component
+ *                         The arguments must be a json-encodable key/value dictionary.
  * @return void
  */
-function display_react_front(string $url, array $arguments) {
+function send_react_front(string $url, array $arguments) {
     // the $url and $argument values are used into the included file
     require_once "react-display-file.php";
 }
\ No newline at end of file
