Skip to content

Commit dac9561

Browse files
author
joan
committed
Update addition titles
1 parent 38dd7fa commit dac9561

26 files changed

+115
-107
lines changed

a-new-trend-for-databases.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "A new trend for databases: platforms"
3-
description: "It's about more than the data stored in your table. It's what you can do with that data."
3+
description: "It's about more than the data stored in your table; it's what you can do with that data."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/database-platforms-trend.png
66
alt: Data platforms

auth-js.mdx

+8-8
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Xata and Auth․js on two Nextjs apps: app directory and pages directory"
3-
description: "Let's build Next.js apps with JWT authentication, Auth.js, and Xata."
2+
title: "Build Next.js apps with JWT authentication, Auth.js, and Xata"
3+
description: "Use Xata and Auth․js on two Next․js apps: app directory and pages directory"
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/xata-authjs-nextjs.png
66
alt: Xata and ChatGPT logos
@@ -19,7 +19,7 @@ Working the conditions and conventions of each directory can get you with any ro
1919

2020
Before going into the Next.js specifics, let's first understand our goals with this project. Visualizing the mental model is an important step to ensure your user's data is switching hands as little as possible.
2121

22-
## Defining a Mental Model
22+
## Defining a mental model
2323

2424
A diagram is probably the fastest way to visualizing a process. This is important to see if there aren't any redundant calls, or if any of those requests are chained in some condition. Chained requests are the grim reapers of perceived performance, we need to get those out of the way as soon as possible.
2525

@@ -249,7 +249,7 @@ Finally, all code is in place to:
249249

250250
What we need now is a set of keys to effectively connect to those services in a secure way.
251251

252-
## Setup Environment Variables
252+
## Configure environment variables
253253

254254
The environment variables `GITHUB_ID` and `GITHUB_SECRET` are provided by GitHub once you register an [OAuth App](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app). For your code to run properly you will need to have a `.env` (or `.env.local`) file looking like:
255255

@@ -269,7 +269,7 @@ NEXTAUTH_SECRET=<a random secret string>
269269

270270
Finally, it's time to manage some data.
271271

272-
## Fetching User Data
272+
## Fetching user data
273273

274274
There are a few ways with which you can provide secure access to routes in your Auth.js app. One is via the Auth.js middleware, this will redirect anyone without a `session` automatically to the login route you set up. This approach should work in both App Directory and Pages Directory.
275275

@@ -279,7 +279,7 @@ Lastly, in the app directory, the best way is to use `getServerSession` method,
279279

280280
When working with React Server components, don't worry about firing multiple requests, it always hit the same endpoint and therefore Next.js will be able to deduplicate it, so there will only be one fetch request.
281281

282-
## Accessing User Specific Data
282+
## Accessing user specific data
283283

284284
Once we got Auth setup, we can treat Row-Level Security (RLS) as an if/else statement. For example, take this contrived profile page:
285285

@@ -306,7 +306,7 @@ export const getServerSideProps = async ({
306306
}
307307
```
308308

309-
In the above example, we are using the user's email as their unique identifier (or Primary Key). And we implemented a getter in a file named `db.server.ts`. Let's see how that looks like using the Xata SDK.
309+
In the above example, we are using the user's email as their unique identifier (or primary key). And we implemented a getter in a file named `db.server.ts`. Let's see how that looks like using the Xata SDK.
310310

311311
```tsx
312312
// the file generated via our CLI
@@ -358,7 +358,7 @@ export const fetchData = async (userEmail: string) => {
358358
};
359359
```
360360

361-
## Working Code
361+
## Working code
362362

363363
Now that we are done, you can compare your code or check the components that we wrote to use this logic in our examples repository:
364364

branching-benefits-git-databases.mdx

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "How branching brings predictability to web development"
3-
description: "Let's explore the benefits of branching in developer workflows, and how Xata brings these benefits to data infrastructure."
2+
title: "Branching brings predictability to web development"
3+
description: "Explore the advantages of branching in developer workflows and how Xata brings these benefits to data infrastructure."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/branching-benefits-git-databases.png
66
alt: Xata
@@ -26,7 +26,7 @@ Unlike tree branches, though, Git branches are capable of merging with another b
2626

2727
![Merging Feature Branches into a Main Branch in Git](https://c-v.sh/unforgeddiddlers.png)
2828

29-
### Branching & Pull Requests
29+
### Branching and pull requests
3030

3131
Another Git feature that goes hand-in-hand with branching to enhance the predictability of the development process is _pull requests_. It's especially powerful today because of how some tools in the Git ecosystem—like [GitHub](https://github.com/), [Bitbucket](https://bitbucket.org/product), and [GitLab](https://about.gitlab.com/)—have built additional functionality around pull requests to promote better collaboration among developers and continuous integration.
3232

@@ -36,7 +36,7 @@ You can use PRs to not only review the code that is being pushed to the main bra
3636

3737
[Vercel](https://vercel.com/)'s [deploy preview](https://vercel.com/features/previews) feature is one of the latest tools that takes advantage of the branching and pull request mechanisms to extend the predictability Git offers beyond the code level.
3838

39-
### Deployment Previews with Vercel
39+
### Deployment previews with Vercel
4040

4141
Vercel allows deploying websites directly from a Git repository hosted on GitHub, GitLab, or Bitbucket. Once you declare the repository's production branch, every time you commit changes to it through merging pull requests, Vercel automatically rebuilds and deploys the website to its platform.
4242

bulletproof-docs-links.mdx

+6-6
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "A journey to bulletproof links in documentation"
3-
description: "How we permanently fixed the problem of broken internal links in our documentation."
3+
description: "Learn how we solved the issue of broken internal links in our documentation, once and for all."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/bulletproof-docs-links.png
66
alt: Xata
@@ -29,9 +29,9 @@ So far, we had no way to make sure that links between pages were working and tha
2929
position="center"
3030
/>
3131

32-
This is fine, we all make mistakes, but let’s learn from this together!
32+
This is fine! We all make mistakes, but let’s learn from this together!
3333

34-
## The Plan
34+
## The plan
3535

3636
The first step is to list our requirements so we have our goal well defined. We want quick feedback if something gets broken, so we can fix it before merging to production. For that, we need to be able to run the docs consistently in different environments:
3737

@@ -151,7 +151,7 @@ and another [link](/rest-api/delete)
151151

152152
That’s essentially all we need for a proof of concept (POC), we are now more confident that we should be able to extract every link from our documentation. Let’s try with some real data!
153153

154-
## The Real Deal
154+
## The real deal
155155

156156
First, we need a way to load all our Markdown files. Luckily, [npm](https://www.notion.so/A-Journey-to-Bulletproof-Links-in-Documentation-f108c0ed0acd464bb1e6310519d19e37) already has a solution for us. 😀
157157

@@ -203,7 +203,7 @@ And… it works! Not useful yet, but we are going in the right direction!
203203
position="center"
204204
/>
205205

206-
This is also a nice opportunity for us to see what links we actually have! And we can already spot some patterns that we need to deal with as external links (example: [`https://stackoverflow.com/questions/4423061/how-can-i-view-http-headers-in-google-chrome`](https://stackoverflow.com/questions/4423061/how-can-i-view-http-headers-in-google-chrome)) and links with anchors (example: `/cli/getting-started#code-generation`)
206+
This is also a nice opportunity for us to see what links we actually have! We can already spot some patterns that we need to deal with as external links (example: [`https://stackoverflow.com/questions/4423061/how-can-i-view-http-headers-in-google-chrome`](https://stackoverflow.com/questions/4423061/how-can-i-view-http-headers-in-google-chrome)) and links with anchors (example: `/cli/getting-started#code-generation`)
207207

208208
First, let’s exclude external links, they are out of our scope since we’re not interested in _other people’s 404s._ We may add this later since we don’t want to link to broken content in the longer term, but for now **scope hammering keeps us focused**.
209209

@@ -447,7 +447,7 @@ await unified()
447447
});
448448
```
449449

450-
## The Wrap Up
450+
## The wrap-up
451451

452452
This is the final version (the one used in our actual documentation repository!)
453453

chatgpt-on-your-data.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Xata & OpenAI: ChatGPT for your data"
3-
description: Xata now lets you ask your data questions.
3+
description: Use Xata to you ask your data questions.
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/chatgpt-on-your-data.png
66
alt: Xata and ChatGPT logos

data-modeling-in-typescript.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "The importance of data modeling in TypeScript"
3-
description: "A deep dive into TypeScript to demonstrate the importance of data modeling"
3+
description: "Take a deep dive into TypeScript to explore the importance of data modeling"
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/the-importance-of-data-modeling-in-typescript.png
66
alt: "The importance of data modeling in TypeScript"

datetime-picker.mdx

+5-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Building a datetime picker for a database"
3-
description: "How we built a next-gen datetime picker for a next-gen database."
3+
description: "Learn how we built a next-generation datetime picker for a next-generation database."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/date-time-picker-for-databases.png
66
alt: Xata
@@ -34,13 +34,16 @@ All of Xata’s datetimes are saved and returned with the UTC timezone.
3434

3535
Xata has two main personas:
3636

37+
* Developers
38+
* Low-code users
39+
3740
##### Developers
3841

3942
At it’s core, Xata is a database aimed at developers.
4043

4144
Developers are power users: They’re comfortable with not leaving their keyboard, they understand datetime strings, and, most of all, they love and respect the UTC timezone.
4245

43-
##### Low code users
46+
##### Low-code users
4447

4548
Entrepreneurs, hackers, customer success, you name it.
4649

hackmamba.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Hackmamba jamstack content hackathon 2.0"
3-
description: "Learning, writing, and networking during two full weeks! This last Hackmamba Jamstack Content Hackathon 2.0. was quite a journey!"
2+
title: "Hackmamba Jamstack Content Hackathon 2.0"
3+
description: "Learning, writing, and networking for two full weeks"
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/hackmamba.png
66
alt: Winnders
@@ -30,4 +30,4 @@ You can find all published posts https://dev.to/hackmamba
3030

3131
These articles are great if you're looking for some good examples to get started with Xata. If you're looking to try Xata out as the year winds down, be sure to enter your app in the [Xata Challenge](https://xata.io/challenge)!
3232

33-
Come chat with us on [discord](https://xata.io/discord) if you have any questions or simply want to talk data.
33+
Chat with us on [Discord](https://xata.io/discord) if you have any questions or simply want to talk data.

hello-world.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Hello, world! Xata raises $5M for a new type of serverless database"
3-
description: "If you haven't heard of us before, it's because we haven't launched yet. We're busy building the product, but we don't believe in stealth mode, so we'd rather talk to you about what we're building and why."
3+
description: "Learn what Xata is and how it can revolutionize your development experience."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/hello-world.png
66
alt: Xata

how-to-fuzzy-search-with-xata.mdx

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "How to fuzzy search with Xata"
3-
description: "Xata is a serverless database built on PostgreSQL with data automatically replicated to Elasticsearch. This opens a whole new world of possibilities when it comes to free text search. Deep dive into Queen Raae's favorite Xata feature, fuzzy search."
3+
description: "Explore the world of free text search possibilities with Xata and take a deep dive into fuzzy search."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/how-to-fuzzy-search-with-xata.png
66
alt: How to Fuzzy Search with Xata
@@ -28,7 +28,7 @@ Fuzzy search to the rescue! 💪
2828

2929
> **FYI:** The example code uses a Xata Worker using the Xata SDK + a React component using ReactQuery. However, you may use any type of server-side + client-side setup you are comfortable with.
3030
31-
## Fuzzy Search Is Enabled by Default
31+
## Fuzzy search is enabled by default
3232

3333
Xata search functionality comes with the `fuzziness` param set to `1` by
3434
default, letting the user make one typo, such as one wrong character
@@ -126,7 +126,7 @@ export default function App() {
126126
Other possible levels of `fuzziness` are `0`, to disable it altogether, and `2`
127127
to extend the allowed typo tolerance. Higher than `2` is not supported.
128128

129-
## Highlight the Relevant Text
129+
## Highlight the relevant text
130130

131131
In addition to expecting a more forgiving search, users expect to know precisely
132132
_why_ a result matches their search term. With a fuzzy search, that is even more
@@ -238,7 +238,7 @@ export default function App() {
238238
}
239239
```
240240

241-
## Search Playground
241+
## Search playground
242242

243243
Xata even allows you to play around with search—no code needed—using the Search
244244
Engine Playground.
@@ -255,7 +255,7 @@ coding.
255255
position="center"
256256
/>
257257

258-
## Where To Go From Here?
258+
## Where to go from here?
259259

260260
I hope you are excited to dig into fuzzy search with Xata:
261261

how-xata-powers-search-for-rankone.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "How Xata powers search for RankOne’s social platform"
3-
description: "How RankOne is using Xata to bring streamers closer to their audience."
2+
title: "Xata powers search for RankOne’s social platform"
3+
description: "RankOne is using Xata to bring streamers closer to their audience."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/community-spotlight-rankone.png
66
alt: Rankone

jamstack-a-deep-dive.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Jamstack: a deep dive"
3-
description: "This post is an in-depth look at the Jamstack, how it compares to other alternatives, and how Xata aims to complete it by providing a serverless database."
3+
description: "Explore Jamstack, its alternatives, and how Xata complements it with a serverless database."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/jamstack-mern-lamp-stack-comparison.png
66
alt: Xata

new-starters.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "New starter templates for Xata"
3-
description: "To help in your journey with Xata, we are providing more and more starters! Today will be about SolidStart, Astro, and SvelteKit. Have fun!"
2+
title: "Take a closer look at Xata's latest starter templates"
3+
description: "Begin your Xata journey with our new starters - SolidStart, Astro, and SvelteKit."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/new-starters-solidstart-sveltekit-astro.png
66
alt: Winnders

offsite-for-a-fully-remote-team.mdx

+16-11
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Offsite for our fully remote team"
3-
description: "Last week we did our first Xata off-site, in Marbella, Spain. This is a photo-blog post about how it went and what we've learned from it. Warning: this post might make you hungry."
2+
title: "Coming together to build Xata"
3+
description: "Take a look at our photo-blog post about Xata's first off-site, featuring insights on our learnings."
44
image:
55
src: https://raw.githubusercontent.com/xataio/mdx-blog/main/images/offsite-for-a-fully-remote-team.png
66
alt: Xata
@@ -10,11 +10,11 @@ published: true
1010
slug: offsite-for-a-fully-remote-team
1111
---
1212

13-
Xata is a fully remote team with employees in Spain, Germany, Andorra, Belgium, and the US, with plans to add more countries soon. To compensate for our mostly Zoom-based work lives, we’re meeting in person a few times per year for an offsite in a nice location.
13+
Xata is a fully remote team with employees located in Spain, Germany, Andorra, Belgium, and the US, and we have plans to expand to more countries soon. To make up for our primarily Zoom-based work culture, we arrange to meet in person several times per year at an offsite location.
1414

15-
Last week, we had our first such offsite in Marbella, Spain, and here is how we did it and what we have learned from it.
15+
Last week, we had our first such offsite in Marbella, Spain, and here is how we did it and what we learned from it.
1616

17-
Fair warning: the photos in this post might make you hungry.
17+
Warning: the photos in this post might make you hungry.
1818

1919
## Preparation
2020

@@ -47,7 +47,8 @@ The game plan was:
4747

4848
Like in a conference where the most valuable track is the “hallway track”, more important than the agenda was what we discussed during breaks, during dinners, or simply on the bus. So we made sure the schedule had plenty of breathing air for us to know each other.
4949

50-
## Monday: arrivals
50+
## Monday
51+
### Arrivals
5152

5253
For many of us, this was the day that we met in person for the first time, despite working together for several months already. This made everyone very excited to meet each other. When we reached the hotel, the Xatafly — which is how we nicknamed our logo — was there to welcome us.
5354

@@ -63,7 +64,8 @@ In the evening we had our first dinner with the whole team, and we learned quick
6364
/>
6465
![Dinner on the first evening](/images/blog/marbella/IMG_6425.jpg)
6566

66-
## Tuesday: Team, strategy, and messaging
67+
## Tuesday
68+
### Team, strategy, and messaging
6769

6870
We started by discussing our [Series A](https://xata.io/blog/xata-series-a-announcement) announcement and what it means for our overall strategy. We then did a team retrospective which was a very open discussion and gave us a lot of food for thought. Speaking of food, the frequent “coffee breaks” included a lot more than coffee, more like a full buffet. It’s ok, we can diet the week after.
6971

@@ -89,7 +91,8 @@ Dinner was again fabulous.
8991
position="center"
9092
/>
9193

92-
## Wednesday: Planning and roadmap
94+
## Wednesday
95+
### Planning and roadmap
9396

9497
A few brave people started the day early with a workout at the hotel gym. The rest of us found reasonable excuses to not do that.
9598

@@ -117,7 +120,8 @@ In the evening, for a change, we cooked our own food! Our amazing teacher Jose s
117120
position="center"
118121
/>
119122

120-
## Thursday: Fun day
123+
## Thursday
124+
### Fun day
121125

122126
We started the day by walking down to the port of Marbella for a Catamaran trip. The water was choppy which means that we didn’t see dolphins as we were hoping but the waves kept us entertained.
123127

@@ -132,7 +136,8 @@ After another delicious lunch, we visited Cueva del Tesoro and the beautiful cit
132136
position="center"
133137
/>
134138

135-
## Friday: travel back home
139+
## Friday
140+
### Travel back home
136141

137142
After dinner on Thursday evening, we hugged and said goodbye, because many of us had flights or trains early in the morning on Friday. Others could stay a bit more and enjoy the beautiful weather.
138143

@@ -145,7 +150,7 @@ After dinner on Thursday evening, we hugged and said goodbye, because many of us
145150
position="center"
146151
/>
147152

148-
## Learnings and conclusions
153+
## Takeaways and conclusions
149154

150155
- There was a lot of laughter during the off-site. Coming after the long pandemic and the associated social distancing, it reminded us just how important laughing together is.
151156
- As a remote-first company, we do a lot of work async and in writing. Meeting each other for a few days did wonders in associating a friendly voice and tone with future written comments.

0 commit comments

Comments
 (0)