Restore erronously removed docs.

Restores the part of the docs that was removed by mistake.

Author: gorkem

docs/how-to-guides.md

@@ -11,13 +11,21 @@ Whether you're working with an existing ModelKit's Kitfile,
 or starting from nothing, the `kitops` package can help you
 get this done.
 
+### Installation
+
 Install the `kitops` package from PYPI into your project's environment
 with the following command
 
 ```sh
 pip install kitops
 ```
 
+### Creating a Kitfile
+
+There are two main ways to work with Kitfiles: creating from scratch or loading an existing one.
+
+#### Loading an Existing Kitfile
+
 Inside of your code you can now import the `Kitfile`
 class from the `kitops.modelkit.kitfile` module:
 
@@ -38,6 +46,8 @@ print(my_kitfile.to_yaml())
 # located at: /path/to/Kitfile
 ```
 
+#### Creating a New Kitfile
+
 You can also create an empty Kitfile from scratch:
 
 ```python
@@ -53,21 +63,165 @@ Regardless of how you created the Kitfile, you can update its contents
 like you would do with any other python dictionary:
 
 ```python
-my_kitfile.manifestVersion = "3.0"
-my_kitfile.package = {
-    "name": "Another-Package",
-    "version": "3.0.0",
-    "description": "Another description",
-    "authors": ["Someone"]
+from kitops.modelkit.kitfile import Kitfile
+
+# Create new Kitfile
+kitfile = Kitfile()
+
+# Set basic metadata
+kitfile.manifestVersion = "1.0"
+kitfile.package = {
+    "name": "sample-kitfile",
+    "version": "1.0",
+    "description": "Sample kitfile for PyKitOps demonstration"
 }
-print(my_kitfile.to_yaml())
+
+# Configure model information
+kitfile.model = {
+    "name": "sample-model",
+    "path": "model/model.pkl",
+    "license": "Apache 2.0",
+    "version": "1.0",
+    "description": "Sample Model"
+}
+
+# Add code files
+kitfile.code = [
+    {
+        "path": "demo.py",
+        "description": "Sample model to demonstrate PyKitOps SDK",
+        "license": "Apache 2.0"
+    },
+    {
+        "path": "requirements.txt",
+        "description": "Python dependencies"
+    }
+]
+
+# Add datasets
+kitfile.datasets = [
+    {
+        "name": "dataset",
+        "path": "data/sample.csv",
+        "description": "full dataset",
+        "license": "Apache 2.0"
+    }
+]
+
+# Add documentation
+kitfile.docs = [
+    {"path": "docs/README.md"},
+    {"path": "docs/LICENSE"}
+]
 
 # OUTPUT:
-#   manifestVersion: '3.0'
-#   package:
-#       name: Another-Package
-#       version: 3.0.0
-#       description: Another description
-#       authors:
-#       - Someone
+# manifestVersion: '1.0'
+# package:
+#   name: sample-kitfile
+#   version: '1.0'
+#   description: Sample kitfile for PyKitOps demonstration
+# code:
+# - path: demo.py
+#   description: Sample model to demonstrate PyKitOps SDK
+#   license: Apache 2.0
+# - path: requirements.txt
+#   description: Python dependencies
+# datasets:
+# - name: dataset
+#   path: data/sample.csv
+#   description: full dataset
+#   license: Apache 2.0
+# docs:
+# - path: docs/README.md
+# - path: docs/LICENSE
+# model:
+#   name: sample-model
+#   path: model/model.pkl
+#   license: Apache 2.0
+#   version: '1.0'
+#   description: Sample Model
 ```
+
+### Pushing to Jozu Hub
+
+Once you've created your Kitfile, you can push it to Jozu Hub using the ModelKitManager. Here's how:
+
+```python
+from kitops.modelkit.manager import ModelKitManager
+
+# Configure the ModelKit manager
+modelkit_tag = "jozu.ml/yourname/reponame:latest"
+manager = ModelKitManager(
+    working_directory=".",
+    modelkit_tag=modelkit_tag
+)
+
+# Assign your Kitfile
+manager.kitfile = kitfile
+
+# Pack and push to Jozu Hub
+manager.pack_and_push_modelkit(save_kitfile=True)
+```
+
+### Complete Example
+
+Here's a complete script that creates a Kitfile and pushes it to Jozu Hub:
+
+```python
+import os
+from kitops.modelkit.kitfile import Kitfile
+from kitops.modelkit.manager import ModelKitManager
+
+if __name__ == "__main__":
+    # Create the Kitfile
+    kitfile = Kitfile()
+    kitfile.manifestVersion = "1.0"
+    kitfile.package = {
+        "name": "sample-kitfile",
+        "version": "1.0",
+        "description": "Sample kitfile for PyKitOps demonstration"
+    }
+    
+    kitfile.model = {
+        "name": "sample-model",
+        "path": "model/model.pkl",
+        "license": "Apache 2.0",
+        "version": "1.0",
+        "description": "Sample Model"
+    }
+    
+    kitfile.code = [
+        {
+            "path": "demo.py",
+            "description": "Sample model to demonstrate PyKitOps SDK",
+            "license": "Apache 2.0"
+        },
+        {
+            "path": "requirements.txt",
+            "description": "Python dependencies"
+        }
+    ]
+    
+    kitfile.datasets = [
+        {
+            "name": "dataset",
+            "path": "data/sample.csv",
+            "description": "full dataset",
+            "license": "Apache 2.0"
+        }
+    ]
+    
+    kitfile.docs = [
+        {"path": "docs/README.md"},
+        {"path": "docs/LICENSE"}
+    ]
+    
+    # Push to Jozu Hub
+    modelkit_tag = "jozu.ml/yourname/reponame:latest"
+    manager = ModelKitManager(
+        working_directory=".",
+        modelkit_tag=modelkit_tag
+    )
+    manager.kitfile = kitfile
+    manager.pack_and_push_modelkit(save_kitfile=True)
+    ```