Skip to content

Commit

Permalink
Merge pull request #12 from TheDuckAI/old-doc
Browse files Browse the repository at this point in the history
refined old doc
  • Loading branch information
bat-kryptonyte authored Sep 29, 2023
2 parents 40a7112 + 3b9ca10 commit 6f6c0a2
Showing 1 changed file with 89 additions and 23 deletions.
112 changes: 89 additions & 23 deletions src/screens/Documentation/Documentation.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,12 @@ import {
Icon,
Code,
} from "@chakra-ui/react";
import { FaArrowCircleRight } from "react-icons/fa";
import {
FaArrowCircleRight
} from "react-icons/fa";

const Documentation: React.FC = () => {

return (
<Box bg="#F9FAFC">
<Flex
Expand Down Expand Up @@ -52,24 +55,14 @@ const Documentation: React.FC = () => {
API Documentation
</Heading>
<Text mb={4}>
We provide a simple API to access the Advanced Reasoning Benchmark
(ARB). The API currently supports standard HTTP GET requests.
We provide a simple API to access the Advanced Reasoning Benchmark (ARB). The API currently supports standard HTTP GET requests.
</Text>

<Heading as="h2" size="xl" mb={6}>
API Calls
</Heading>
<Text mb={4}>
We have three different types of API calls for retrieving problems.
See{" "}
<Link
href="https://app.swaggerhub.com/apis-docs/arb-dataset/arb-api/1.0.5"
color="teal.500"
>
here
</Link>{" "}
and select ARB API server as the mock server to see what the outputs
look like.
We have three different types of API calls for retrieving problems. See <Link href="https://app.swaggerhub.com/apis-docs/arb-dataset/arb-api/1.0.5" color="teal.500">here</Link> and select ARB API server as the mock server to see what the outputs look like.
</Text>

<Heading as="h3" size="lg" mb={4}>
Expand All @@ -78,20 +71,76 @@ const Documentation: React.FC = () => {
<Text mb={4}>
You can retrieve all the problems in a particular subject area by the
following API call. Acceptable values for `category` are `law`,
`math`, and `mcatReading`.
`math`, `mcatReading`, etc.
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>https://advanced-reasoning-benchmark.netlify.app/api/lib/{"{category}"}</Code>
</Box>
<Text fontWeight="bold" mb={2}>
Math Numerical:
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
import requests
<br />
response =
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/math&quot;)
<br />
data = response.json()
</Code>
</Box>

<Text fontWeight="bold" mb={2}>
Math Symbolic:
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
import requests
<br />
response =
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/testSplit/math/symbolic&quot;)
<br />
data = response.json()
</Code>
</Box>

<Text fontWeight="bold" mb={2}>
Math Proofs:
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
import requests
<br />
response =
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/testSplit/math/proof&quot;)
<br />
data = response.json()
</Code>
</Box>

<Text fontWeight="bold" mb={2}>
Physics Numerical:
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>https://arb.duckai.org/api/lib/{"{category}"}</Code>
<Code>
import requests
<br />
response =
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/physics/val&quot;)
<br />
data = response.json()
</Code>
</Box>

<Text fontWeight="bold" mb={2}>
Math:
Physics Symbolic:
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
import requests
<br />
response =
requests.get(&quot;https://arb.duckai.org/api/lib/math&quot;)
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/testSplit/physics/val&quot;)
<br />
data = response.json()
</Code>
Expand All @@ -105,7 +154,7 @@ const Documentation: React.FC = () => {
import requests
<br />
response =
requests.get(&quot;https://arb.duckai.org/api/lib/law&quot;)
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/law&quot;)
<br />
data = response.json()
</Code>
Expand All @@ -119,7 +168,7 @@ const Documentation: React.FC = () => {
import requests
<br />
response =
requests.get(&quot;https://arb.duckai.org/api/lib/mcatReading&quot;)
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/mcatReading&quot;)
<br />
data = response.json()
</Code>
Expand All @@ -130,15 +179,15 @@ const Documentation: React.FC = () => {
</Heading>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
https://arb.duckai.org/api/lib/{"{category}"}/{"{id}"}
https://advanced-reasoning-benchmark.netlify.app/api/lib/{"{category}"}/{"{id}"}
</Code>
</Box>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
import requests
<br />
response =
requests.get(&quot;https://arb.duckai.org/api/lib/math/1234&quot;)
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/math/1234&quot;)
<br />
problem = response.json()
</Code>
Expand All @@ -149,15 +198,31 @@ const Documentation: React.FC = () => {
</Heading>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
https://arb.duckai.org/api/lib/{"{category}"}/{"{variation}"}
https://advanced-reasoning-benchmark.netlify.app/api/lib/{"{category}"}/{"{variation}"}
</Code>
</Box>
<Text fontWeight="bold" mb={2}>
Physics Numerical w/ Images:
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
import requests
<br />
response =
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/physics_numerical/img&quot;)
<br />
variation_data = response.json()
</Code>
</Box>
<Text fontWeight="bold" mb={2}>
Physics Symbolic w/ Images:
</Text>
<Box p={4} mb={4} borderWidth="1px" borderRadius="md" bg="gray.50">
<Code>
import requests
<br />
response =
requests.get(&quot;https://arb.duckai.org/api/lib/physics_numerical/img&quot;)
requests.get(&quot;https://advanced-reasoning-benchmark.netlify.app/api/lib/testSplit/physics/img&quot;)
<br />
variation_data = response.json()
</Code>
Expand Down Expand Up @@ -188,3 +253,4 @@ const Documentation: React.FC = () => {
};

export default Documentation;

0 comments on commit 6f6c0a2

Please sign in to comment.