Merge pull request #7007 from janhq/docs/update-handbook

docs: update handbook

Author: mmngn

docs/src/pages/handbook/_meta.json

@@ -1,4 +1,8 @@
 {
   "index": "Overview",
-  "why": "Why does Jan exist?"
+  "why": "Why Does Jan Exist?",
+  "what-jan-is": "What Is Jan?",
+  "who": "Who Are We?",
+  "join-us": "How to Join Us?"
+
 }

docs/src/pages/handbook/index.mdx

@@ -1,23 +1,29 @@
 ---
 title: "Jan Team Handbook"
-description: "Building superintelligence that you can own and run anywhere."
+description: "Jan is a general purpose AI agent that works on its own to get things done."
 ---
 
 # Jan Handbook
-
-> Jan's Handbook is inspired by [Posthog](https://posthog.com/handbook) and [Gitlab](https://handbook.gitlab.com/).
-> Thank you for showing us the way.
+> Jan's Handbook is inspired by [Posthog](https://posthog.com/handbook) and [Gitlab](https://handbook.gitlab.com/). Thanks for showing us the way.
 
 ## Welcome
 
-This handbook explains how [Jan](https://jan.ai) works, and is public.
+Welcome to [Jan](https://jan.ai)!
+
+This handbook explains what Jan is, what we stand for, and how you can be part of it.
+
+Jan is built in public by a team that believes AI should get things done, not just talk about getting things done. We're open source, we move fast, and we build alongside the people using what we make.
+
+This handbook is a living thing. It grows as Jan grows - new ideas, new tools, new ways to make AI that actually works for you.
+
+## Overview
+
+Jan is a general purpose AI agent that works on its own to get things done.
 
-We're building superintelligence that you can self-host and use locally. Not as a limitation, but as a feature. Your AI should work wherever you need it - on your laptop during a flight, on your company's servers for compliance, or in the cloud for scale.
+Give Jan something to work on, maybe research for a brief, a report you have been putting off, or an analysis you need to pull together, and it will run for as long as needed. It could be five hours or ten. Jan figures it out, does the work, and finishes the job.
 
-Jan's Handbook is a [living document](https://en.wikipedia.org/wiki/Living_document), constantly evolving as we build the future of AI ownership.
+Think of it like this: you hand off the task, Jan handles it, and you get on with your day.
 
-## Why does Jan exist?
+Jan is open source and built by a vibrant global community. Anyone can use it, contribute to it, or host it themselves.
 
-- [Open Superintelligence](/handbook/open-superintelligence) - Building superintelligence that belongs to everyone, not just a few tech giants. We believe the future of AI should be open, accessible, and owned by the people who use it.
-- [Betting on Open-Source](/handbook/why/betting-on-open-source)
-Why we're betting on open-source as the future of AI and technology. Open-source has consistently won in the long term, and AI will be no different.
+Jan gets it done. That is the whole idea.

docs/src/pages/handbook/join-us.mdx

@@ -0,0 +1,35 @@
+---
+title: "How to Join Us?"
+description: "Ways to get involved with Jan."
+---
+
+# How to Join Us
+
+Jan works because people contribute. The more people who use it, improve it, and share it, the better it gets.
+
+## Join the community
+
+Start in our [Discord](https://discord.gg/FTk2MvZwJH). That's where everything happens. You can:
+
+* Join discussions and follow what we are building
+* Share ideas, feedback, and experiments
+* Learn from others and help newcomers find their way
+
+## Contribute
+
+Jan is [open source](https://github.com/janhq). You can:  
+
+* Write or review code
+* Report bugs or give feedback
+
+## Work with us
+
+Want to build Jan full-time? → [Careers](https://menlo.bamboohr.com/careers/)
+
+## Partner or invest
+
+Believe in what we're building? → [[email protected]](mailto:[email protected])
+
+## Share Jan
+
+Tell people about us on [X](https://x.com/jandotai), [Threads](https://www.threads.com/@jandotai), [Bluesky](https://bsky.app/profile/jandotai.bsky.social), [LinkedIn](https://www.linkedin.com/company/opensuperintelligence), and [r/askjan](https://www.reddit.com/r/askjan/).

docs/src/pages/handbook/what-jan-is.mdx

@@ -0,0 +1,32 @@
+---
+title: "What is Jan?"
+description: "Jan is a general purpose AI agent that works on its own to get things done."
+---
+
+# What is Jan
+Jan is both a product suite and a family of models we train in-house:
+
+## Applications:
+
+We're building Jan to work wherever you do. Jan is available on:
+
+* [Desktop](https://www.jan.ai/download)
+* [Browser](https://chat.jan.ai/)
+* Browser Extension (coming soon)
+* Jan Server
+
+Whether you prefer working from your desktop, need quick access through your browser, or want Jan on the go with mobile - use it however makes sense for you.
+
+Over time, we expect most people will use Jan through the browser as we continue improving the web experience. 
+
+## Models:
+
+* Jan-v2: our multimodal agent built for long-horizon tasks
+* Jan-v1: web search capabilities
+* Ichigo: speech AI for voice interactions
+
+Training our own models means we can optimise for how agents actually work - planning, executing, and completing tasks autonomously over hours, not just answering questions.
+
+This won't be easy. Building agents that work reliably for hours - sometimes 5, sometimes 10 - without supervision is genuinely hard. We're still early. But the problem is real, the technology is ready, and we think this is the right direction.
+
+

docs/src/pages/handbook/who/_meta.json

@@ -0,0 +1,4 @@
+{
+  "who-we-are": "Who We Are",
+  "how-we-work": "How We Work"
+}

docs/src/pages/handbook/who/how-we-work.mdx

@@ -0,0 +1,46 @@
+---
+title: "How We Work"
+description: "Jan is a distributed team building in public. We value ownership, transparency, and shipping fast."
+---
+
+# How We Work
+
+Jan is a distributed team. Some of us work remotely, though our home base is in Ho Chi Minh City, Vietnam, right on [Nguyen Hue Street](https://maps.app.goo.gl/NguyenHueStreet). We meet in person when it helps us think better together.
+
+We keep things simple:
+
+* Write things down
+* Share early and often  
+* Make decisions visible
+* Ship first, refine after
+
+## Own the work
+
+We trust people to do great work without micromanagement. Owning the work means treating Jan like it's yours - you take initiative, follow through, and help teammates succeed.
+
+**What this looks like:**
+
+* Pick up problems without being asked
+* Finish what you start
+* Take responsibility for outcomes, not just tasks
+
+## Build in public
+
+Our code, plans, and discussions are mostly open. We default to transparency because open work builds better products and earns trust. When everyone can see how things work, everyone can help make them better.
+
+**What this looks like:**
+
+* Default to sharing
+* Give and receive feedback openly (and kindly)
+* Explain your decisions so others can learn
+
+## Who thrives here
+
+We don't care about perfect profiles or pedigree. We care about people who:
+
+* Ship things
+* Care about the outcome
+* Want to build something genuinely useful
+* Learn fast by doing, not debating
+
+**Does this sound like you?** → We'd love to meet you! Check our [Careers](https://menlo.bamboohr.com/careers/) page.

docs/src/pages/handbook/who/who-we-are.mdx

@@ -0,0 +1,20 @@
+---
+title: "Who We Are"
+description: "We're building Jan because we believe AI agents should work for everyone, everywhere."
+---
+
+# Who We Are
+
+We're building Jan because we believe AI agents should get things done for everyone, everywhere - not just serve a handful of markets or companies.
+
+## Our team
+
+We hire from unconventional backgrounds because we know talent is everywhere but opportunity isn't. Our team includes people who've taken non-traditional paths into tech - and we think that diversity of experience leads to better lateral thinking and sharper problem-solving.
+
+We're a small team, mostly based in Ho Chi Minh City, Vietnam. Being outside the usual tech hubs means we see problems and opportunities others miss. We're building for markets and users that don't fit the standard Silicon Valley playbook.
+
+## What guides us
+
+We're solarpunk optimists. We think technology can genuinely improve life when it's built openly, with the right intent, and by people who care about making something useful.
+
+We believe AI should serve humanity, not nations or corporate interests. That's why Jan is open source and built with a global community.

docs/src/pages/handbook/why/_meta.json

@@ -1,4 +1,4 @@
 {
-  "open-superintelligence": "Why Jan exists",
-  "betting-on-open-source": "Why we're betting on open-source"
+  "why-jan-exists": "Why Jan Exists",
+  "open-source": "Open Source & Community"
 }

docs/src/pages/handbook/why/betting-on-open-source.mdx

@@ -0,0 +1,36 @@
+---
+title: "Open Source & Community"
+description: "Jan is open-source AI that works everywhere."
+---
+
+# Open Source & Community
+
+AI is increasingly concentrated - built in a few places, controlled by a few companies, available in select markets.
+
+Jan takes a different approach. We're open source because we think AI agents should work everywhere, not just where it's convenient to operate.
+
+## Why open source matters
+
+AI agents are becoming critical tools. When you depend on something to get real work done, you shouldn't be locked into one company's roadmap or survival.
+
+Open source means:
+* **You're not stuck:** run Jan yourself, fork it, modify it. Your future isn't tied to our business decisions
+* **You can see how it works:** no black boxes, no hidden mechanics. The code is there
+* **You can make it better:** found a bug? Fixed something? Let us know!
+
+## Built with a global community
+
+Jan isn't just open source in theory. We're one of the fastest-growing open source AI projects:
+* 12+ core team members across time zones
+* 100+ contributors improving Jan every day
+* 2,800+ pull requests merged
+* 4.5M+ downloads and counting
+* 16K+ community members in Discord
+
+Most of our work happens in the open - on GitHub for development, Discord for everything else. Our community includes developers, designers, researchers, and curious users from around the world.
+
+## Join us
+
+* **Want to talk?** → Join our [Discord](https://discord.gg/FTk2MvZwJH). That's where everything happens - discussions, feedback, help, collaboration
+* **Want to contribute?** → We're on [GitHub](https://github.com/janhq). Code, docs, bug reports, ideas - all welcome
+* **Want to build Jan full-time?** → Check our [Careers](https://menlo.bamboohr.com/careers/) page