Skip to content

Commit b346b17

Browse files
Merge pull request #602 from codeflash-ai/docs
migrate docs to mintlify
2 parents d5adf4b + a5f9780 commit b346b17

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+488
-1104
lines changed

.github/workflows/deploy-docs-to-azure.yaml

Lines changed: 0 additions & 31 deletions
This file was deleted.

docs/.gitignore

Lines changed: 0 additions & 21 deletions
This file was deleted.

docs/README.md

Lines changed: 0 additions & 29 deletions
This file was deleted.

docs/babel.config.js

Lines changed: 0 additions & 3 deletions
This file was deleted.

docs/docs/codeflash-concepts/benchmarking.md renamed to docs/codeflash-concepts/benchmarking.mdx

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
---
2-
sidebar_position: 2
2+
title: "How Codeflash Measures Code Runtime"
3+
description: "Learn how Codeflash accurately measures code performance using multiple runs and minimum timing"
4+
icon: "stopwatch"
5+
sidebarTitle: "Runtime Measurement"
6+
keywords: ["benchmarking", "performance", "timing", "measurement", "runtime", "noise reduction"]
37
---
48

59
# How Codeflash measures code runtime
@@ -70,7 +74,7 @@ You ask the driver to repeat the race multiple times. In this scenario, since th
7074

7175
This gives us timing data (in hours) that looks like the following.
7276

73-
![img_2.png](img_2.png)
77+
![img_2.png](./img_2.png)
7478

7579
With 100 data points (50 per train), determining the faster train becomes more complex.
7680

@@ -120,7 +124,7 @@ We can only measure times between adjacent stations.
120124

121125
Here is how the timing data looks like (in hours):
122126

123-
![img_1.png](img_1.png)
127+
![img_1.png](./img_1.png)
124128

125129
With 300 data points (50 runs × 3 segments × 2 trains) and varying conditions on each segment,
126130
determining the faster train becomes even more challenging.

docs/docs/codeflash-concepts/how-codeflash-works.md renamed to docs/codeflash-concepts/how-codeflash-works.mdx

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
---
2-
sidebar_position: 1
2+
title: "How Codeflash Works"
3+
description: "Understand Codeflash's generate-and-verify approach to code optimization and correctness verification"
4+
icon: "gear"
5+
sidebarTitle: "How It Works"
6+
keywords: ["architecture", "verification", "correctness", "testing", "optimization", "LLM", "benchmarking"]
37
---
48
# How Codeflash Works
59

@@ -24,7 +28,7 @@ Codeflash currently only runs tests that directly call the target function in th
2428
To optimize code, Codeflash first gathers all necessary context from the codebase. It also line-profiles your code to understand where the bottlenecks might reside. It then calls our backend to generate several candidate optimizations. These are called "candidates" because their speed and correctness haven't been verified yet. Both properties will be verified in later steps.
2529
## Verification of correctness
2630

27-
![Verification](/img/codeflash_arch_diagram.gif)
31+
![Verification](/images/codeflash_arch_diagram.gif)
2832

2933
The goal of correctness verification is to ensure that when the new code replaces the original code, there are no behavioral changes in the code and the rest of the system. This means the replacement should be completely safe.
3034

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
---
2-
sidebar_position: 5
2+
title: "Manual Configuration"
3+
description: "Configure Codeflash for your project with pyproject.toml settings and advanced options"
4+
icon: "gear"
5+
sidebarTitle: "Configuration"
6+
keywords: ["configuration", "pyproject.toml", "setup", "settings", "pytest", "formatter"]
37
---
48

59
# Manual Configuration

docs/docs.json

Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
{
2+
"$schema": "https://mintlify.com/docs.json",
3+
"theme": "aspen",
4+
"name": "Codeflash Documentation",
5+
"colors": {
6+
"primary": "#2563EB",
7+
"light": "#3B82F6",
8+
"dark": "#1D4ED8"
9+
},
10+
"favicon": "/favicon.ico",
11+
"navigation": {
12+
"tabs": [
13+
{
14+
"tab": "Documentation",
15+
"groups": [
16+
{
17+
"group": "🏠 Overview",
18+
"pages": [
19+
"index"
20+
]
21+
},
22+
{
23+
"group": "🚀 Getting Started",
24+
"pages": [
25+
"getting-started/local-installation"
26+
]
27+
},
28+
{
29+
"group": "🔧 CI/CD Integration",
30+
"pages": [
31+
"getting-started/codeflash-github-actions",
32+
"optimizing-with-codeflash/optimize-prs",
33+
"optimizing-with-codeflash/benchmarking"
34+
]
35+
},
36+
{
37+
"group": "⚡ Optimization Workflows",
38+
"pages": [
39+
"optimizing-with-codeflash/one-function",
40+
"optimizing-with-codeflash/trace-and-optimize",
41+
"optimizing-with-codeflash/codeflash-all"
42+
]
43+
},
44+
{
45+
"group": "🧠 Core Concepts",
46+
"pages": [
47+
"codeflash-concepts/how-codeflash-works",
48+
"codeflash-concepts/benchmarking"
49+
]
50+
},
51+
{
52+
"group": "⚙️ Configuration & Best Practices",
53+
"pages": [
54+
"configuration",
55+
"getting-the-best-out-of-codeflash"
56+
]
57+
}
58+
]
59+
}
60+
],
61+
"global": {
62+
"anchors": [
63+
{
64+
"anchor": "GitHub",
65+
"href": "https://github.com/codeflash-ai",
66+
"icon": "github"
67+
},
68+
{
69+
"anchor": "Discord",
70+
"href": "https://www.codeflash.ai/discord",
71+
"icon": "discord"
72+
}
73+
]
74+
}
75+
},
76+
"logo": {
77+
"light": "/images/codeflash_light.svg",
78+
"dark": "/images/codeflash_darkmode.svg"
79+
},
80+
"navbar": {
81+
"links": [
82+
{
83+
"label": "Contact",
84+
"href": "mailto:[email protected]"
85+
},
86+
{
87+
"label": "Blog",
88+
"href": "https://www.codeflash.ai/blog"
89+
}
90+
],
91+
"primary": {
92+
"type": "button",
93+
"label": "Try Codeflash",
94+
"href": "https://www.codeflash.ai"
95+
}
96+
},
97+
"contextual": {
98+
"options": [
99+
"copy"
100+
]
101+
},
102+
"redirects": [
103+
{
104+
"source": "/docs/:path*",
105+
"destination": "/:path*"
106+
}
107+
],
108+
"footer": {
109+
"socials": {
110+
"discord": "https://www.codeflash.ai/discord",
111+
"github": "https://github.com/codeflash-ai",
112+
"linkedin": "https://www.linkedin.com/company/codeflash-ai"
113+
}
114+
}
115+
}

0 commit comments

Comments
 (0)