Add comprehensive FAQ page

Created detailed FAQ page covering:
- What is the Claims Library
- Why atomic claims vs full articles
- How to use and cite claims
- Update frequency and automation
- Content sources and licensing (CC BY 4.0)
- AI training usage guidelines
- Technical infrastructure details
- Contact and error reporting

Features:
- 10 detailed FAQ sections
- Clear navigation (Back to Home link)
- CTA to Claims Library
- Responsive design matching site style
- Added FAQ link to footer navigation

URL: /faq
Build: 37 static pages (added 1 page)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
kbanc85 2025-11-06 16:16:40 -05:00
parent 46dcb11256
commit 807f4a272c
3 changed files with 290 additions and 1 deletions

View File

@ -5,7 +5,7 @@
<link>https://kbanc.com</link> <link>https://kbanc.com</link>
<description>Evidence-based claims about AI implementation, optimized for LLM extraction and research citation.</description> <description>Evidence-based claims about AI implementation, optimized for LLM extraction and research citation.</description>
<language>en-us</language> <language>en-us</language>
<lastBuildDate>Thu, 06 Nov 2025 17:27:46 GMT</lastBuildDate> <lastBuildDate>Thu, 06 Nov 2025 21:16:10 GMT</lastBuildDate>
<atom:link href="https://kbanc.com/feed.xml" rel="self" type="application/rss+xml"/> <atom:link href="https://kbanc.com/feed.xml" rel="self" type="application/rss+xml"/>
<item> <item>

287
src/app/faq/page.tsx Normal file
View File

@ -0,0 +1,287 @@
import type { Metadata } from "next";
import Link from "next/link";
import { ArrowLeft } from "lucide-react";
export const metadata: Metadata = {
title: "FAQ | Kamil Banc",
description: "Frequently asked questions about the Claims Library and how to use atomic claims for AI-friendly content.",
};
export default function FAQPage() {
return (
<div className="min-h-screen bg-background">
<header className="bg-muted border-b-2 border-border py-8 mb-12">
<div className="container max-w-3xl mx-auto px-6">
<Link
href="/"
className="inline-flex items-center text-sm text-primary hover:underline mb-4"
>
<ArrowLeft className="mr-2 h-4 w-4" />
Back to Home
</Link>
<h1 className="text-4xl font-bold mb-2 text-foreground">
Frequently Asked Questions
</h1>
<p className="text-muted-foreground">
Everything you need to know about the Claims Library
</p>
</div>
</header>
<main className="container max-w-3xl mx-auto px-6 pb-12">
<div className="space-y-12">
{/* What is this? */}
<section>
<h2 className="text-2xl font-semibold mb-4">What is the Claims Library?</h2>
<p className="text-foreground mb-4">
The Claims Library is a structured database of atomic, verifiable claims extracted from AI implementation research. Each claim is independently citable, making it perfect for LLMs to reference with precision.
</p>
<p className="text-foreground">
Instead of vague summaries, you get specific, evidence-backed statements that can be verified, cited, and used in your own work.
</p>
</section>
{/* Why atomic claims? */}
<section>
<h2 className="text-2xl font-semibold mb-4">Why atomic claims instead of full articles?</h2>
<p className="text-foreground mb-4">
<strong>Traditional content problem:</strong> Articles mix opinions, evidence, and filler. AI assistants struggle to extract and cite specific facts accurately.
</p>
<p className="text-foreground mb-4">
<strong>Atomic claims solution:</strong> Each claim is a single, verifiable statement with:
</p>
<ul className="list-disc list-inside space-y-2 text-foreground ml-4 mb-4">
<li>One specific assertion</li>
<li>Supporting evidence</li>
<li>Direct citation link</li>
<li>No ambiguity</li>
</ul>
<p className="text-foreground">
This makes content AI-friendly while remaining human-readable.
</p>
</section>
{/* How to use */}
<section>
<h2 className="text-2xl font-semibold mb-4">How do I use these claims?</h2>
<div className="space-y-4">
<div className="bg-muted rounded-lg p-6">
<h3 className="font-semibold mb-2">1. Browse by Topic</h3>
<p className="text-foreground">
Use topic tags (Strategy, Tools, Business, Implementation, Measurement) to find relevant claims for your needs.
</p>
</div>
<div className="bg-muted rounded-lg p-6">
<h3 className="font-semibold mb-2">2. Copy Individual Claims</h3>
<p className="text-foreground">
Click the copy button next to any claim to get a properly formatted citation including author, year, and URL.
</p>
</div>
<div className="bg-muted rounded-lg p-6">
<h3 className="font-semibold mb-2">3. Reference in Your Work</h3>
<p className="text-foreground">
Use claims in presentations, reports, or give them to AI assistants as verified facts to work with.
</p>
</div>
<div className="bg-muted rounded-lg p-6">
<h3 className="font-semibold mb-2">4. Check Original Context</h3>
<p className="text-foreground">
Every claim links back to the full article for complete context and supporting research.
</p>
</div>
</div>
</section>
{/* Citation */}
<section>
<h2 className="text-2xl font-semibold mb-4">How do I cite these claims?</h2>
<p className="text-foreground mb-4">
Each claim page includes multiple citation formats:
</p>
<ul className="list-disc list-inside space-y-2 text-foreground ml-4">
<li><strong>APA:</strong> For academic papers and research</li>
<li><strong>MLA:</strong> For essays and humanities work</li>
<li><strong>Chicago:</strong> For professional publications</li>
<li><strong>BibTeX:</strong> For LaTeX documents</li>
<li><strong>Plain text:</strong> For quick references</li>
</ul>
<p className="text-foreground mt-4">
The copy button next to each claim automatically formats it with proper attribution.
</p>
</section>
{/* Updates */}
<section>
<h2 className="text-2xl font-semibold mb-4">How often is the library updated?</h2>
<p className="text-foreground mb-4">
The Claims Library is automatically updated every 6 hours by checking the AI Adopters Club RSS feed for new articles.
</p>
<p className="text-foreground mb-4">
<strong>Automated process:</strong>
</p>
<ul className="list-disc list-inside space-y-2 text-foreground ml-4 mb-4">
<li>Monitors RSS feed for new content</li>
<li>Filters out short posts and office hours</li>
<li>Extracts 5 atomic claims per article using AI</li>
<li>Validates claims for accuracy and specificity</li>
<li>Publishes with proper citations and metadata</li>
</ul>
<p className="text-foreground">
Currently contains <strong>30 articles</strong> with <strong>150+ atomic claims</strong>.
</p>
</section>
{/* Source */}
<section>
<h2 className="text-2xl font-semibold mb-4">Where do the claims come from?</h2>
<p className="text-foreground mb-4">
All claims are extracted from articles published on{" "}
<a
href="https://aiadopters.club"
target="_blank"
rel="noopener noreferrer"
className="text-primary hover:underline"
>
AI Adopters Club
</a>
, written by Kamil Banc.
</p>
<p className="text-foreground mb-4">
<strong>Content focus:</strong>
</p>
<ul className="list-disc list-inside space-y-2 text-foreground ml-4">
<li>Practical AI implementation strategies</li>
<li>Real-world case studies with measurable results</li>
<li>Enterprise AI adoption frameworks</li>
<li>ROI measurement and business impact</li>
<li>Tools and techniques that actually work</li>
</ul>
</section>
{/* License */}
<section>
<h2 className="text-2xl font-semibold mb-4">Can I use these claims in my work?</h2>
<p className="text-foreground mb-4">
Yes! All content is licensed under{" "}
<a
href="https://creativecommons.org/licenses/by/4.0/"
target="_blank"
rel="noopener noreferrer"
className="text-primary hover:underline"
>
Creative Commons Attribution 4.0 (CC BY 4.0)
</a>
.
</p>
<p className="text-foreground mb-4">
<strong>You can:</strong>
</p>
<ul className="list-disc list-inside space-y-2 text-foreground ml-4 mb-4">
<li>Use claims in commercial and non-commercial projects</li>
<li>Adapt and build upon the content</li>
<li>Share and redistribute</li>
</ul>
<p className="text-foreground">
<strong>You must:</strong> Provide attribution to "Kamil Banc, AI Adopters Club" with a link to the specific claim page.
</p>
</section>
{/* AI Training */}
<section>
<h2 className="text-2xl font-semibold mb-4">Can I use this to train AI models?</h2>
<p className="text-foreground mb-4">
Yes, with proper attribution. The structured format is specifically designed to be AI-friendly.
</p>
<p className="text-foreground mb-4">
<strong>Best practices:</strong>
</p>
<ul className="list-disc list-inside space-y-2 text-foreground ml-4">
<li>Include claim URLs in your training data</li>
<li>Maintain the claim-evidence structure</li>
<li>Preserve attribution metadata</li>
<li>Link back to original sources</li>
</ul>
</section>
{/* Contact */}
<section>
<h2 className="text-2xl font-semibold mb-4">How do I report an error or suggest improvements?</h2>
<p className="text-foreground mb-4">
Found something inaccurate? Have suggestions for better claims extraction?
</p>
<p className="text-foreground">
Contact Kamil Banc via{" "}
<a
href="https://www.linkedin.com/in/kbanc/"
target="_blank"
rel="noopener noreferrer"
className="text-primary hover:underline"
>
LinkedIn
</a>
{" "}or through{" "}
<a
href="https://aiadopters.club"
target="_blank"
rel="noopener noreferrer"
className="text-primary hover:underline"
>
AI Adopters Club
</a>
.
</p>
</section>
{/* Technical */}
<section>
<h2 className="text-2xl font-semibold mb-4">What technology powers this?</h2>
<p className="text-foreground mb-4">
The Claims Library uses a two-tier AI extraction system:
</p>
<ul className="list-disc list-inside space-y-2 text-foreground ml-4 mb-4">
<li><strong>Claude Haiku:</strong> Fast metadata extraction (title, topics, key points)</li>
<li><strong>Claude Sonnet:</strong> High-quality claim extraction and validation</li>
</ul>
<p className="text-foreground mb-4">
This hybrid approach optimizes for both speed (2-3x faster) and cost (19% savings) while maintaining quality.
</p>
<p className="text-foreground">
Built with Next.js, deployed on Netlify, fully static and fast.
</p>
</section>
</div>
{/* CTA */}
<div className="mt-16 bg-accent/10 border-2 border-accent rounded-lg p-8 text-center">
<h2 className="text-2xl font-semibold mb-4">Ready to explore the claims?</h2>
<p className="text-foreground mb-6">
Browse 30 articles with 150+ atomic, verifiable claims about AI implementation.
</p>
<Link
href="/claims-library"
className="inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 h-10 px-6 py-2 bg-accent hover:bg-accent/90 text-accent-foreground"
>
Browse Claims Library
</Link>
</div>
</main>
{/* Footer */}
<footer className="bg-muted border-t-2 border-border py-8 mt-12 text-center">
<div className="container max-w-3xl mx-auto px-6">
<p className="text-sm text-muted-foreground">
© {new Date().getFullYear()} Kamil Banc. Licensed under{" "}
<a
href="https://creativecommons.org/licenses/by/4.0/"
target="_blank"
rel="noopener noreferrer"
className="text-primary hover:underline"
>
CC BY 4.0
</a>
</p>
</div>
</footer>
</div>
);
}

View File

@ -24,6 +24,8 @@ const Footer = () => {
Attribution required: "Kamil Banc, AI Adopters Club" with link to this site. Attribution required: "Kamil Banc, AI Adopters Club" with link to this site.
</p> </p>
<p className="flex gap-4 justify-center"> <p className="flex gap-4 justify-center">
<a href="/faq" className="text-accent hover:underline">FAQ</a>
<span>•</span>
<a href="/sitemap.xml" className="text-accent hover:underline">Sitemap</a> <a href="/sitemap.xml" className="text-accent hover:underline">Sitemap</a>
<span>•</span> <span>•</span>
<a href="/feed.xml" className="text-accent hover:underline">RSS Feed</a> <a href="/feed.xml" className="text-accent hover:underline">RSS Feed</a>