1
00:00:00,000 --> 00:00:04,080
Welcome back to the Deep Dive, the show where we dig into a ton of information and

2
00:00:04,080 --> 00:00:04,400
try to make

3
00:00:04,400 --> 00:00:08,340
sense of it all for you, turning complex stuff into, well, hopefully, clear

4
00:00:08,340 --> 00:00:10,000
knowledge. Today,

5
00:00:10,000 --> 00:00:14,240
we're diving into a really interesting tool. It's kind of changing the game for how

6
00:00:14,240 --> 00:00:14,800
people build

7
00:00:14,800 --> 00:00:19,350
websites, especially sites that are really heavy on content. Now, before we jump

8
00:00:19,350 --> 00:00:19,840
right in,

9
00:00:19,840 --> 00:00:24,100
we want to give a quick shout out to our supporter, Safe Server. They're fantastic

10
00:00:24,100 --> 00:00:24,560
at helping with

11
00:00:24,560 --> 00:00:28,460
your digital transformation journey, and they also handle the hosting for powerful

12
00:00:28,460 --> 00:00:28,960
software,

13
00:00:28,960 --> 00:00:32,400
kind of like the stuff we're about to talk about today. You can find out more about

14
00:00:32,400 --> 00:00:32,800
them at

15
00:00:32,800 --> 00:00:38,480
www.safeserver.de. Seriously, it's thanks to supporters like Safe Server that we

16
00:00:38,480 --> 00:00:39,040
can do these

17
00:00:39,040 --> 00:00:46,090
deep dives. Okay, so today's focus, DocuSaurus. If you've ever, you know, wanted to

18
00:00:46,090 --> 00:00:46,560
build a really

19
00:00:46,560 --> 00:00:50,380
nice website, maybe for documentation or a project or even a blog, but you felt

20
00:00:50,380 --> 00:00:51,360
kind of stopped by

21
00:00:51,360 --> 00:00:54,140
the technical side of things, well, DocuSaurus might just be the answer you're

22
00:00:54,140 --> 00:00:54,800
looking for.

23
00:00:54,800 --> 00:00:58,560
Our mission today is to really unpack it. What is DocuSaurus? Why is it such a big

24
00:00:58,560 --> 00:00:59,280
deal for building

25
00:00:59,280 --> 00:01:03,930
efficient content for sites? And crucially, how does it make things easier, even if

26
00:01:03,930 --> 00:01:04,640
you're just

27
00:01:04,640 --> 00:01:09,680
starting out? All right, let's get into it. At its core, what exactly is DocuSaurus?

28
00:01:09,680 --> 00:01:09,760
Well,

29
00:01:09,760 --> 00:01:16,410
fundamentally, DocuSaurus is this framework, right? Specifically designed to make

30
00:01:16,410 --> 00:01:17,520
it way easier to

31
00:01:18,240 --> 00:01:24,220
build, deploy, and importantly, maintain websites, especially for open source

32
00:01:24,220 --> 00:01:25,760
projects initially.

33
00:01:25,760 --> 00:01:30,090
But it's useful way beyond that. Think of it like a specialized platform for

34
00:01:30,090 --> 00:01:30,720
websites,

35
00:01:30,720 --> 00:01:35,490
where the information is the main thing. Your docs, your blog posts, your tutorials,

36
00:01:35,490 --> 00:01:36,400
that's the star.

37
00:01:36,400 --> 00:01:40,750
And the big idea, the real promise, is that it helps you build these optimized

38
00:01:40,750 --> 00:01:42,160
websites fast,

39
00:01:42,160 --> 00:01:47,070
so you can spend your time on the actual content, not wrestling with complex web

40
00:01:47,070 --> 00:01:48,320
development stuff

41
00:01:48,320 --> 00:01:52,400
upfront. Which is totally different from how you might traditionally build a site,

42
00:01:52,400 --> 00:01:55,680
where setting up the basics can take ages before you write a single word.

43
00:01:55,680 --> 00:01:59,530
That sounds amazing, that idea of focusing just on the content. But how does it

44
00:01:59,530 --> 00:02:00,160
actually do that?

45
00:02:00,160 --> 00:02:03,760
What's the magic behind the scenes that lets you just write?

46
00:02:03,760 --> 00:02:06,400
Yeah, that's where this thing called MDX comes in. It's actually pretty clever. You

47
00:02:06,400 --> 00:02:06,800
probably know

48
00:02:06,800 --> 00:02:10,000
Markdown, right? That simple text formatting you use for remes or notes.

49
00:02:10,000 --> 00:02:10,640
Sure.

50
00:02:10,640 --> 00:02:15,120
So MDX is like Markdown, but with the really cool superpower,

51
00:02:15,120 --> 00:02:20,080
you can embed React components directly inside your text.

52
00:02:20,080 --> 00:02:23,440
Wait, React component, like the building blocks for web interfaces?

53
00:02:23,440 --> 00:02:23,840
Exactly.

54
00:02:23,840 --> 00:02:28,480
So you're saying I could be writing a document and then just dropping an

55
00:02:28,480 --> 00:02:29,680
interactive chart or a code

56
00:02:29,680 --> 00:02:32,620
playground or something right there in the middle of the text without getting

57
00:02:32,620 --> 00:02:33,600
tangled in loads of

58
00:02:33,600 --> 00:02:34,240
JavaScript.

59
00:02:34,240 --> 00:02:38,720
Precisely. That's the key. You just write your stuff using this enhanced Markdown,

60
00:02:38,720 --> 00:02:39,360
this MDX.

61
00:02:39,920 --> 00:02:42,480
And DocuSource handles the heavy lifting.

62
00:02:42,480 --> 00:02:46,400
It takes those files and turns them into static HTML pages.

63
00:02:46,400 --> 00:02:48,960
Static HTML. Okay, so that means they're pre-built.

64
00:02:48,960 --> 00:02:52,000
Right. Think of it like baking a cake beforehand. It's all ready to go.

65
00:02:52,000 --> 00:02:56,080
When someone visits your site, the page is served up instantly,

66
00:02:56,080 --> 00:02:58,960
super fast, very secure, and cheap to host, too.

67
00:02:58,960 --> 00:03:02,720
It really streamlines the whole thing, lets you focus on the message,

68
00:03:02,720 --> 00:03:06,160
but still gives you the power to add those dynamic bits when you need them.

69
00:03:06,160 --> 00:03:10,480
So it's not just about getting text online, it's about getting a high quality

70
00:03:10,480 --> 00:03:14,960
fast site running with like minimal hassle, cutting out that initial setup pain.

71
00:03:14,960 --> 00:03:18,720
That makes total sense. DocuSaurus basically handles the build process,

72
00:03:18,720 --> 00:03:20,960
freeing you up to actually communicate.

73
00:03:20,960 --> 00:03:24,560
Okay, that's a really strong pitch for starting something new,

74
00:03:24,560 --> 00:03:27,520
but you mentioned it's more than just getting a basic site up.

75
00:03:27,520 --> 00:03:31,920
It sounds like DocuSaurus has some pretty powerful features built in

76
00:03:31,920 --> 00:03:36,000
that make it suitable for bigger projects, maybe growing communities, too.

77
00:03:36,000 --> 00:03:38,320
What are some of those standout capabilities?

78
00:03:38,320 --> 00:03:40,800
Yeah, absolutely. That's a really important point.

79
00:03:40,800 --> 00:03:44,160
One huge strength is that it's built using React itself.

80
00:03:44,160 --> 00:03:48,240
So if you or your team already know React,

81
00:03:48,240 --> 00:03:52,720
you've got a massive amount of flexibility to customize the site's look and feel,

82
00:03:52,720 --> 00:03:55,360
add new features using standard web tech.

83
00:03:55,360 --> 00:03:57,440
It uses what they call a pluggable architecture.

84
00:03:57,440 --> 00:03:59,520
Pluggable architecture, like Lego.

85
00:03:59,520 --> 00:04:01,440
Kinda, yeah. Think of it like that.

86
00:04:01,440 --> 00:04:05,200
DocuSaurus gives you this solid base, the core structure.

87
00:04:05,200 --> 00:04:08,880
But because it's pluggable, you can easily add or swap out different pieces,

88
00:04:08,880 --> 00:04:11,920
maybe a custom search feature, a different kind of sidebar,

89
00:04:11,920 --> 00:04:16,160
integrations with other tools, without having to rebuild everything from scratch.

90
00:04:16,160 --> 00:04:18,160
You get a lot of power to make it unique,

91
00:04:18,160 --> 00:04:22,320
while still using all the data and systems DocuSaurus manages through its plugins.

92
00:04:22,320 --> 00:04:27,680
Okay, so developers get a solid foundation but can still build custom stuff on top

93
00:04:27,680 --> 00:04:31,520
without reinventing the wheel for common things like navigation or search.

94
00:04:31,520 --> 00:04:32,720
That sounds efficient.

95
00:04:32,720 --> 00:04:33,600
It really is.

96
00:04:33,600 --> 00:04:36,400
What about reaching people worldwide?

97
00:04:36,400 --> 00:04:39,760
Does DocuSaurus help with, say, translations?

98
00:04:39,760 --> 00:04:41,840
Oh definitely, that's a massive plus.

99
00:04:41,840 --> 00:04:46,160
Localization, you know, translation support, it comes right out of the box.

100
00:04:46,160 --> 00:04:47,520
Really? Out of the box?

101
00:04:47,520 --> 00:04:51,410
Yep, which is a huge time saver for any project aiming for an international

102
00:04:51,410 --> 00:04:51,920
audience.

103
00:04:51,920 --> 00:04:56,400
It makes it surprisingly easy to translate your docs into different languages.

104
00:04:56,400 --> 00:05:00,080
You can manage the translations using tools developers often already use,

105
00:05:00,080 --> 00:05:04,400
like Git or specific platforms like Crowdon. And what's really neat is you can

106
00:05:04,400 --> 00:05:05,040
deploy these

107
00:05:05,040 --> 00:05:09,140
translated versions separately. So your French site can update independently from

108
00:05:09,140 --> 00:05:09,600
your English

109
00:05:09,600 --> 00:05:14,010
one, for example. It supports languages like French, Brazilian, Portuguese, Korean,

110
00:05:14,010 --> 00:05:14,480
Chinese.

111
00:05:14,480 --> 00:05:18,720
Simplifies that whole complex multilingual setup.

112
00:05:18,720 --> 00:05:21,120
That's also a major headache for global projects.

113
00:05:21,120 --> 00:05:26,720
Okay, thinking about software specifically, projects have different versions, right?

114
00:05:26,720 --> 00:05:32,560
Version 1, version 2. How does DocuSource deal with keeping the docs aligned with

115
00:05:32,560 --> 00:05:32,960
the right

116
00:05:32,960 --> 00:05:38,460
software version? Ah, yes. Document versioning. That's another lifesaver feature.

117
00:05:38,460 --> 00:05:38,960
For any project

118
00:05:38,960 --> 00:05:42,460
that evolves, like software releases, DocuSource has a system to keep the

119
00:05:42,460 --> 00:05:43,760
documentation perfectly

120
00:05:43,760 --> 00:05:48,540
in sync with each version. So imagine you have users on version 1.0, but new folks

121
00:05:48,540 --> 00:05:49,280
are using 2.0.

122
00:05:49,280 --> 00:05:50,320
Right, common scenario.

123
00:05:50,320 --> 00:05:53,280
DocuSource makes sure that when someone searches or browsers,

124
00:05:53,280 --> 00:05:56,080
they see the docs for their specific version automatically.

125
00:05:56,080 --> 00:05:56,800
Oh, that's smart.

126
00:05:56,800 --> 00:05:59,520
Yeah, it prevents so much confusion. No more looking at outdated

127
00:05:59,520 --> 00:06:03,200
instructions or features that don't exist yet. Everyone gets the right info for the

128
00:06:03,200 --> 00:06:03,520
version

129
00:06:03,520 --> 00:06:04,480
they're actually using.

130
00:06:04,480 --> 00:06:08,080
That's a really thoughtful design, anticipating how people actually use docs.

131
00:06:08,080 --> 00:06:14,240
Okay, and one more thing. Big documentation sites can be hard to navigate. Finding

132
00:06:14,240 --> 00:06:15,280
that one specific

133
00:06:15,280 --> 00:06:19,280
piece of info. How does DocuSource tackle search?

134
00:06:19,280 --> 00:06:22,800
Good search is critical, absolutely. And DocuSource integrates really well with

135
00:06:22,800 --> 00:06:26,960
Algolia Documentation Search. Algolia? I've heard of them. They're specialists in

136
00:06:26,960 --> 00:06:27,680
search, right?

137
00:06:27,680 --> 00:06:32,240
Exactly. It's not just some basic keyword search. Algolia is powerful. Designed

138
00:06:32,240 --> 00:06:32,960
specifically for

139
00:06:32,960 --> 00:06:37,440
documentation. It understands context. It handles typos gracefully. And it delivers

140
00:06:37,440 --> 00:06:38,240
really relevant

141
00:06:38,240 --> 00:06:42,080
results, even if you have a huge amount of content. So users can actually find what

142
00:06:42,080 --> 00:06:43,200
they need quickly.

143
00:06:43,200 --> 00:06:47,360
Yep. Makes the docs way more useful. Okay, so we've covered what it is.

144
00:06:47,360 --> 00:06:53,040
The core ideas, these powerful features like React extensibility, localization,

145
00:06:53,040 --> 00:06:53,600
versioning,

146
00:06:53,600 --> 00:06:59,590
Algolia search. But what's the real world story? Is this like a niche tool or is it

147
00:06:59,590 --> 00:07:00,240
actually making

148
00:07:00,240 --> 00:07:04,000
waves out there? Oh, it's definitely making waves. A big splash. Yeah. The adoption

149
00:07:04,000 --> 00:07:04,640
numbers are pretty

150
00:07:04,640 --> 00:07:14,640
telling. On GitHub, DocuSource has over 61,000 stars and more than 9,300 forks. Wow.

151
00:07:14,640 --> 00:07:14,720
Okay. And

152
00:07:14,720 --> 00:07:18,080
those aren't just numbers on a screen, right? They represent a really active,

153
00:07:18,080 --> 00:07:19,040
engaged community

154
00:07:19,040 --> 00:07:24,040
building with it and contributing back. Plus, it's used by over 11,700 projects now.

155
00:07:24,040 --> 00:07:25,600
11,700. That's a

156
00:07:25,600 --> 00:07:29,570
lot. It is. It shows widespread trust and impact. And you mentioned it's not just

157
00:07:29,570 --> 00:07:30,560
small projects.

158
00:07:30,560 --> 00:07:33,890
There are some pretty big names using it. Yeah, definitely. You've got projects

159
00:07:33,890 --> 00:07:34,480
like Redux,

160
00:07:34,480 --> 00:07:39,700
which is huge in the React world. SuperBase, the open source Firebase alternative.

161
00:07:39,700 --> 00:07:40,400
The IOTA

162
00:07:40,400 --> 00:07:46,080
wiki uses it. Temporal for workflow orchestration. Testing library. These are major

163
00:07:46,080 --> 00:07:46,480
tools and

164
00:07:46,480 --> 00:07:50,480
platforms. Right. Names people definitely recognize. Exactly. And what they say

165
00:07:50,480 --> 00:07:51,360
about it is interesting

166
00:07:51,360 --> 00:07:56,550
too. Mark Erickson from Redux basically said, you know, DocuSource lets them focus

167
00:07:56,550 --> 00:07:57,280
on content.

168
00:07:57,280 --> 00:08:02,560
And it just works. It just works. Developers love hearing that. Don't we all? SuperBase

169
00:08:02,560 --> 00:08:02,800
put it

170
00:08:02,800 --> 00:08:07,630
simply. They spend less time building documentation and more time building their

171
00:08:07,630 --> 00:08:08,800
actual product.

172
00:08:08,800 --> 00:08:13,040
That's the dream. Right. Pretty much. Christopher Chideau, who leads prettier

173
00:08:13,040 --> 00:08:14,400
development at Meta,

174
00:08:14,400 --> 00:08:18,560
talked about the relief of not having to spend a week each time spitting up a new

175
00:08:18,560 --> 00:08:19,120
one

176
00:08:19,120 --> 00:08:23,210
for every new open source site. That's valuable time save. Hugely valuable. And

177
00:08:23,210 --> 00:08:23,680
maybe one of the

178
00:08:23,680 --> 00:08:27,460
most striking examples is Hector Ramos from the React Native team. He said that

179
00:08:27,460 --> 00:08:28,240
after they moved

180
00:08:28,240 --> 00:08:34,080
their docs to DocuSource, open source contributions have skyrocketed. Skyrocketed.

181
00:08:34,080 --> 00:08:35,120
Because it was

182
00:08:35,120 --> 00:08:39,260
easier to contribute. Seems like it. It made the whole process more inviting,

183
00:08:39,260 --> 00:08:40,720
easier to jump into,

184
00:08:40,720 --> 00:08:46,080
which is massive for community health. And, you know, it doesn't hurt that the

185
00:08:46,080 --> 00:08:46,880
project itself

186
00:08:46,880 --> 00:08:50,710
is backed by Meta Platforms Inc., which gives it a solid foundation. Okay, that's

187
00:08:50,710 --> 00:08:51,760
compelling evidence.

188
00:08:51,760 --> 00:08:55,450
So for the listener, maybe someone feeling inspired now who wants to actually try

189
00:08:55,450 --> 00:08:56,400
it out,

190
00:08:56,400 --> 00:09:00,890
how easy is it to get your hands dirty with DocuSource? Is it beginner friendly? It

191
00:09:00,890 --> 00:09:01,200
really

192
00:09:01,200 --> 00:09:05,380
is designed to be approachable. Super low barrier to entry. You can literally try

193
00:09:05,380 --> 00:09:06,160
it out instantly

194
00:09:06,160 --> 00:09:12,050
right in your web browser. No installation needed. Just go to DocuSource.new. DocuSource.new,

195
00:09:12,050 --> 00:09:12,160
like

196
00:09:12,160 --> 00:09:17,040
a live playground. Exactly. Perfect for just kicking the tires, seeing how it feels.

197
00:09:17,040 --> 00:09:20,960
Or if you want to set up a real site on your own machine, it's basically one

198
00:09:20,960 --> 00:09:22,080
command in your terminal.

199
00:09:22,080 --> 00:09:27,840
npm and it's DocuSource at latest. npm and DocuSource at latest. And they even have

200
00:09:27,840 --> 00:09:28,400
a five-minute

201
00:09:28,400 --> 00:09:32,000
tutorial. Seriously, you can go from nothing to a running DocuSource site in just a

202
00:09:32,000 --> 00:09:32,560
few minutes.

203
00:09:32,560 --> 00:09:36,540
They really focused on making that initial step easy. That's fantastic. Removes

204
00:09:36,540 --> 00:09:37,120
that initial

205
00:09:37,120 --> 00:09:40,670
hurdle. And what if someone tries it, loves it, builds something cool, and then

206
00:09:40,670 --> 00:09:41,040
thinks,

207
00:09:41,040 --> 00:09:45,560
hey, I want to help make DocuSource even better. How do they get involved with the

208
00:09:45,560 --> 00:09:46,000
community or

209
00:09:46,000 --> 00:09:51,340
contribute back? Yeah, the DocuSource community is known for being really welcoming.

210
00:09:51,340 --> 00:09:52,160
They actively

211
00:09:52,160 --> 00:09:55,580
encourage contributions. Even if you're new to open source, they actually keep a

212
00:09:55,580 --> 00:09:56,000
list of

213
00:09:56,560 --> 00:10:00,880
beginner-friendly bugs. These are specific issues picked out as good starting

214
00:10:00,880 --> 00:10:01,520
points for new

215
00:10:01,520 --> 00:10:04,960
contributors to learn the ropes. Well, that's smart. It takes away the intimidation

216
00:10:04,960 --> 00:10:05,360
factor.

217
00:10:05,360 --> 00:10:10,400
Totally. And for connecting with people, asking questions, getting help. They have

218
00:10:10,400 --> 00:10:11,040
active Discord

219
00:10:11,040 --> 00:10:14,970
channels. There's a hashtag general channel for users and a hashtag contributors

220
00:10:14,970 --> 00:10:15,520
channel if

221
00:10:15,520 --> 00:10:19,540
you're looking to get involved with the code itself. Plus, you can find them on X

222
00:10:19,540 --> 00:10:20,240
or use GitHub

223
00:10:20,240 --> 00:10:23,510
issues for bug reports and feature discussions. It's a very open and supportive

224
00:10:23,510 --> 00:10:24,240
environment.

225
00:10:24,240 --> 00:10:28,080
Great. So lots of ways to connect and contribute. All right. Well, that brings us

226
00:10:28,080 --> 00:10:29,040
towards the end

227
00:10:29,040 --> 00:10:34,150
of our deep dive into DocuSource today. It seems pretty clear it's much more than

228
00:10:34,150 --> 00:10:34,800
just a website

229
00:10:34,800 --> 00:10:39,430
builder. It's kind of a whole philosophy, isn't it, about simplifying the creation

230
00:10:39,430 --> 00:10:40,320
of these powerful,

231
00:10:40,320 --> 00:10:46,970
good-looking, customizable, translation-ready documentation sites. It really seems

232
00:10:46,970 --> 00:10:47,440
to shift

233
00:10:47,440 --> 00:10:52,000
the focus, letting creators, letting you put your energy where it matters most, the

234
00:10:52,000 --> 00:10:52,960
actual content,

235
00:10:52,960 --> 00:10:56,800
the knowledge you want to share. Absolutely. And that, I think, leads to a really

236
00:10:56,800 --> 00:10:57,200
interesting

237
00:10:57,200 --> 00:11:00,820
question for you, the listener. In this world we live in, just overflowing with

238
00:11:00,820 --> 00:11:01,600
information,

239
00:11:01,600 --> 00:11:05,620
where getting your message across clearly and accessibly is so vital, how could a

240
00:11:05,620 --> 00:11:06,000
tool like

241
00:11:06,000 --> 00:11:11,010
DocuSource fundamentally change the way you, or maybe your project, shares

242
00:11:11,010 --> 00:11:12,160
knowledge and actually

243
00:11:12,160 --> 00:11:16,070
connects with your community? Think about the impact of making your ideas, your

244
00:11:16,070 --> 00:11:16,880
documentation,

245
00:11:16,880 --> 00:11:21,040
instantly available, easy to find, easy to translate. What could that unlock? That's

246
00:11:21,040 --> 00:11:25,520
definitely something to chew on, a great final thought. And with that, a huge thank

247
00:11:25,520 --> 00:11:25,840
you once

248
00:11:25,840 --> 00:11:29,920
again to Safe Server for supporting the show and making these deep dives possible.

249
00:11:29,920 --> 00:11:30,240
Remember,

250
00:11:30,240 --> 00:11:33,600
you can learn more about how they can help with your digital transformation and

251
00:11:33,600 --> 00:11:34,320
hosting needs

252
00:11:34,320 --> 00:11:39,680
over at www.safeserver.de. We definitely encourage you to check out DocuSource

253
00:11:39,680 --> 00:11:40,560
itself, explore the

254
00:11:40,560 --> 00:11:44,320
resources, and keep learning. Until next time, keep diving deep.