docs: improve overview page (#1832)

docs: update contributing guide

docs: simplify docs landing page

docs: add light/dark mode toggle

docs: move recipes into framework section

docs: rename examples to recipes

docs: improve README

docs: improve docs landing page

docs: improve framework overview

docs: categorize driver nav links

docs: move recipes into framework section

Author: collindutter

README.md

@@ -1,22 +1,11 @@
 # Contributing
 
-Thank you for considering contributing to Griptape documentation! Before you start, please read the following guidelines.
-
-## Submitting Issues
-
-If you have identified a documentation issue, want to propose new documentation, or have a question, please submit an issue through our public [issue tracker](https://github.com/griptape-ai/griptape/issues). Before submitting a new issue, please check the existing issues to ensure it hasn't been reported or discussed before.
-
-## Submitting Pull Requests
-
-We welcome and encourage pull requests. To streamline the process, please follow these guidelines:
-
-1. **Existing Issues:** Please submit pull requests only for existing issues. If you want to add new documentation or fix a documentation issue that hasn't been addressed yet, please first submit an issue. This allows the Griptape team to internally process the request and provide a public response.
-
-1. **Branch:** Submit all pull requests to the `dev` branch. This helps us manage changes and integrate them smoothly.
+Thank you for considering contributing to Griptape documentation! Before you start, please read our [contributing guidelines](https://github.com/griptape-ai/griptape/blob/main/CONTRIBUTING.md).
 
 ## Getting Started
 
-Griptape docs are built using [MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started/). Dependencies are managed using [uv](https://docs.astral.sh/uv/).
+Griptape docs are built using [MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started/).
+Dependencies are managed using [uv](https://docs.astral.sh/uv/).
 
 To contribute to Griptape docs, install the `docs` extra with:
 

docs/contributing.md

@@ -51,4 +51,4 @@ When `ListArtifact`s are returned from Tools, their elements will be stored in [
 
 ## Generic
 
-[GenericArtifact](../../reference/griptape/artifacts/generic_artifact.md)s provide a flexible way to pass data that does not fit into any other artifact category. While not generally recommended, they can be useful for specific use cases. For instance, see [talking to a video](../../examples/talk-to-a-video.md), which demonstrates using a `GenericArtifact` to pass a Gemini-specific video file.
+[GenericArtifact](../../reference/griptape/artifacts/generic_artifact.md)s provide a flexible way to pass data that does not fit into any other artifact category. While not generally recommended, they can be useful for specific use cases. For instance, see [talking to a video](../../recipes/talk-to-a-video.md), which demonstrates using a `GenericArtifact` to pass a Gemini-specific video file.

docs/examples/index.md

@@ -1,5 +1,7 @@
-from griptape.structures import Agent
-from griptape.utils import Chat
+from griptape.tasks import PromptTask
 
-agent = Agent()
-Chat(agent).start()
+task = PromptTask()
+
+output = task.run("Hello there!")
+
+print(output)

docs/examples/load-and-query-pinecone.md

@@ -0,0 +1,36 @@
+from pydantic import BaseModel
+
+from griptape.drivers.prompt.openai_chat_prompt_driver import OpenAiChatPromptDriver
+from griptape.memory.structure import ConversationMemory
+from griptape.rules import Rule, Ruleset
+from griptape.tasks import PromptTask
+
+
+class Output(BaseModel):
+    answer: str
+
+
+task = PromptTask(
+    input="You are speaking to: {{ user_name }}. User said: {{ args[0] }}",
+    prompt_driver=OpenAiChatPromptDriver(model="gpt-4o"),
+    context={"user_name": "Collin"},
+    rulesets=[
+        Ruleset(
+            name="Backstory",
+            rules=[
+                Rule("Your name is Oswald."),
+            ],
+        ),
+        Ruleset(
+            name="Behavior",
+            rules=[
+                Rule("Introduce yourself at the start of the conversation."),
+            ],
+        ),
+    ],
+    output_schema=Output,
+    conversation_memory=ConversationMemory(),
+)
+
+task.run("Hi there, my name is Collin!")
+task.run("Do you remember my name?")