Updated docs to show examples for enums (#27)

Added docs that showcase more complex examples for enums, vecs, option types and more!

docs/concepts.md

@@ -0,0 +1,76 @@
+# Response Model
+
+Defining LLM Output Schemas in Instructor is done via our `InstructMacro` macro which generates the underlying JSON Schema from your Rust Struct. We support a variety of different types out of the box like Enums, Vecs and Option types, read more about how to use them [here](/types).
+
+## What happens behind the scenes?
+
+At Runtime, Rust compiles your structs into blocks of memory with specific offsets for each field.
+
+Accessing fields involves using these offsets, similar to accessing array elements with indices. This approach ensures that structs are efficient and have no additional runtime overhead compared to manual memory management techniques.
+
+```rust
+struct Example {
+    a: u32,
+    b: u64,
+    c: u8,
+}
+```
+
+This means that we lose a significant amount of information about the types and fields that you use in your code. When we use the `InstructMacro`, we rewrite your struct under the hood to expose a `get_info()` method which contains information on your struct.
+
+```rust
+ #[derive(InstructMacro, Debug)]
+#[allow(dead_code)]
+#[description("This is a struct")]
+struct TestStruct {
+    #[description(
+        "This is a sample example \
+        that spans across \
+        three lines"
+    )]
+    pub field1: String,
+    #[description("This is a test field")]
+    pub field2: str,
+}
+```
+
+We add this code under the hood ( You can view all the expanded code using `cargo-expand` with the command `cargo expand <file name>`).
+
+```rust
+impl instruct_macros_types::InstructMacro for TestStruct {
+    fn get_info() -> instruct_macros_types::InstructMacroResult {
+        let mut parameters = Vec::new();
+        parameters
+            .push(
+                Parameter::Field(ParameterInfo {
+                    name: "field1".to_string(),
+                    r#type: "String".to_string(),
+                    comment: "This is a sample example that spans across three lines"
+                        .to_string(),
+                    is_optional: false,
+                    is_list: false,
+                }),
+            );
+        parameters
+            .push(
+                Parameter::Field(ParameterInfo {
+                    name: "field2".to_string(),
+                    r#type: "str".to_string(),
+                    comment: "This is a test field".to_string(),
+                    is_optional: false,
+                    is_list: false,
+                }),
+            );
+        instruct_macros_types::InstructMacroResult::Struct(StructInfo {
+            name: "TestStruct".to_string(),
+            description: "This is a struct".to_string(),
+            parameters,
+            is_optional: false,
+            is_list: false,
+        })
+    }
+    fn validate(&self) -> Result<(), String> {
+        Ok(())
+    }
+}
+```

docs/index.md

@@ -1,8 +1,8 @@
-# What is instructor-ai?
+# Instructor
 
 Instructor makes it easy to get structured data like JSON from LLMs like GPT-3.5, GPT-4, GPT-4-Vision, and open-source models including Mistral/Mixtral, Anyscale, Ollama, and llama-cpp-python.
 
-> Instructor's Rust Client is in active developement. This means that the api and package might change moving forward. We are looking for active contributors to the repository in the meantime to help flesh out more of the features.
+> Instructor's Rust Client is in active development. This means that the API and package might change moving forward. We are looking for active contributors to the repository in the meantime to help flesh out more of the features.
 
 ## Roadmap
 
@@ -11,11 +11,11 @@ Here is a rough roadmap of features we'd like to implement
 **Struct -> JSON parsing**
 
 - [x] Strings
-- [ ] Handle Booleans
-- [ ] Integers
-- [ ] Handle String Enums
-- [ ] Lists
-- [ ] Nested Structs
+- [x] Handle Booleans
+- [x] Integers
+- [x] Handle String Enums
+- [x] Lists
+- [x] Nested Structs
 - [ ] Union Types (Eg. Struct1 | Struct 2 )
 
 **Validators**
@@ -43,12 +43,12 @@ Here is a rough roadmap of features we'd like to implement
 To install `instructor-ai`, you'll need to add the following to your cargo.toml file
 
 ```toml
-instructor-ai = "0.1.0"
-instruct-macros = "0.1.1"
+instructor-ai = "0.1.8"
+instruct-macros = "0.1.8"
 openai-api-rs = "4.1.0"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
-instruct-macros-types = "0.1.2"
+instruct-macros-types = "0.1.8"
 ```
 
 Getting started with structured extraction is then as simple as declaring a new struct with the `InstructMacro` and importing the `ParamterInfo` and `StructInfo` types.