Skip to content

Commit

Permalink
fix broken /docs/ links (#463)
Browse files Browse the repository at this point in the history
* fix broken /docs/ links

* fix remaining links
  • Loading branch information
nikolasburk authored Dec 15, 2023
1 parent 5f16106 commit 5c7ac57
Show file tree
Hide file tree
Showing 89 changed files with 4,244 additions and 2,983 deletions.
20 changes: 10 additions & 10 deletions content/01-intro/01-what-are-databases.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: 'What are databases?'
metaTitle: "What Are Databases? Definition, Usage, Examples and Types"
metaTitle: 'What Are Databases? Definition, Usage, Examples and Types'
metaDescription: 'Learn the fundamentals of databases to gain better insight into what Prisma abstracts and how to think of the database layer generally.'
authors: ['justinellingwood']
---
Expand All @@ -11,11 +11,11 @@ Databases are essential components for many modern applications and tools. As a

In this article, we'll go over:

* what databases are
* how they are used by people and applications to keep track of various kinds of data
* what features databases offer
* what types of guarantees they make
* how they compare to other methods of data storage
- what databases are
- how they are used by people and applications to keep track of various kinds of data
- what features databases offer
- what types of guarantees they make
- how they compare to other methods of data storage

Finally, we'll discuss how applications rely on databases for storing and retrieving data to enable complex functionality.

Expand Down Expand Up @@ -260,17 +260,17 @@ Fortunately, there are many different database options designed to fulfil the re

<PrismaOutlinks>

[Prisma](https://www.prisma.io/docs/concepts/overview/what-is-prisma) is one way to make it easy to work with databases from your application. You can learn more about what Prisma offers in our [Why Prisma? page](https://www.prisma.io/docs/concepts/overview/why-prisma).
[Prisma](https://www.prisma.io/docs/orm/overview/introduction/what-is-prisma) is one way to make it easy to work with databases from your application. You can learn more about what Prisma offers in our [Why Prisma? page](https://www.prisma.io/docs/orm/overview/introduction/why-prisma).

[Prisma database connectors](https://www.prisma.io/docs/concepts/database-connectors) allow you to connect Prisma to many different types of databases. Check out our docs to learn more.
[Prisma database connectors](https://www.prisma.io/docs/orm/overview/databases) allow you to connect Prisma to many different types of databases. Check out our docs to learn more.

</PrismaOutlinks>

## FAQ

<details><summary>What are persistent data structures?</summary>

Databases store data either on disk or in-memory. On disk storage is generally said to be *persistent*, meaning that the data is reliably saved for later, even if the database application or the computer itself restarts.
Databases store data either on disk or in-memory. On disk storage is generally said to be _persistent_, meaning that the data is reliably saved for later, even if the database application or the computer itself restarts.

</details>

Expand All @@ -288,7 +288,7 @@ A [database abstraction layer](/intro/database-glossary#database-abstraction-lay

<details><summary>What is database management?</summary>

Database management refers to the actions taken to work with and control data to meet necessary conditions throughout the data lifecycle.
Database management refers to the actions taken to work with and control data to meet necessary conditions throughout the data lifecycle.

Some database management tasks include performance monitoring and tuning, storage and capacity planning, backup and recovery data, data archiving, data partitioning, replication, and more.

Expand Down
2 changes: 1 addition & 1 deletion content/01-intro/02-comparing-database-types.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -539,6 +539,6 @@ Many times, using a mixture of different database types is the best approach for

<PrismaOutlinks>

You can use Prisma work more easily with databases from within your application code. Check out our [database connectors page](https://www.prisma.io/docs/concepts/database-connectors) to see all of the databases Prisma supports.
You can use Prisma work more easily with databases from within your application code. Check out our [database connectors page](https://www.prisma.io/docs/orm/overview/databases) to see all of the databases Prisma supports.

</PrismaOutlinks>
142 changes: 71 additions & 71 deletions content/01-intro/03-intro-to-schemas.mdx

Large diffs are not rendered by default.

1,549 changes: 1,326 additions & 223 deletions content/01-intro/04-database-glossary.mdx

Large diffs are not rendered by default.

10 changes: 5 additions & 5 deletions content/02-datamodeling/01-intro-dont-panic.mdx
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
---
title: "Intro (don't panic)"
metaTitle: "Data modeling | A Quick Introduction"
metaTitle: 'Data modeling | A Quick Introduction'
metaDescription: "Intro (Don't Panic)"
authors: ['dianfay']
---
## Introduction

## Introduction

If you're reading this, you are more than likely being pressed into service as a database architect. This can befall you any number of ways: you might be a developer or analyst tasked with your first (or fortieth) improvement or patch job on an existing data model, or you could be staring down the blank canvas of an empty database like a rookie matador. Two things are certain: first, information needs to be stored and retrieved, as efficiently and conveniently as possible; and second, you're the one who needs to make it work. This guide will help you get to grips with modeling information and producing durable and maintainable database schema designs. We'll concentrate on relational databases for the most part, so you should come into this with a basic grasp of storing and retrieving data with SQL. Ideally, you'll have a database of your own to experiment in; examples will be given for PostgreSQL, a free and open-source database management system.

So: data modeling. Like everything else in computing, it's math once you get right down to it. However, its day-to-day practice is almost entirely abstracted to the level of structuring and managing information as it flows through various systems. We'll touch on some of the mathy fundamentals of sets and predicates later on, but the database designer must solve problems of legibility and maintainability as much as of raw mathematical efficiency. As Heinz Klein and Kalle Lyytinen put it thirty years ago, <footnote> <note> _Towards a New Understanding of Data Modeling_ <br/> in <a href="https://www.researchgate.net/publication/242530010_Software_Development_and_Reality_Construction">Software Development and Reality Construction</a> </note> <text> "the appropriate metaphors for data modelling are not fact gathering and modelling, but negotiation and lawmaking" </text> </footnote>.


This is intended eventually to be a complete crash course in (relational, although not ignoring others) designing data models. For now, we're publishing parts as they're written, and concentrating first on situating databases and data modeling problems in an organization and systems design context, as well as covering some of the less-prominent areas of database functionality.

<PrismaOutlinks>

If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/concepts/overview/what-is-prisma/data-modeling).
If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/orm/overview/introduction/data-modeling).

You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model) section of the Prisma documentation.
You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/orm/prisma-schema/data-model) section of the Prisma documentation.

</PrismaOutlinks>
4 changes: 2 additions & 2 deletions content/02-datamodeling/02-know-your-problem-space.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -81,8 +81,8 @@ The present is more important than the future. If your model is not useful now,

<PrismaOutlinks>

If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/concepts/overview/what-is-prisma/data-modeling).
If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/orm/overview/introduction/data-modeling).

You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model) section of the Prisma documentation.
You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/orm/prisma-schema/data-model) section of the Prisma documentation.

</PrismaOutlinks>
4 changes: 2 additions & 2 deletions content/02-datamodeling/04-tables-tuples-types.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -85,8 +85,8 @@ Coming up in [_Correctness and Constraints_](correctness-constraints), we'll cov

<PrismaOutlinks>

If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/concepts/overview/what-is-prisma/data-modeling).
If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/orm/overview/introduction/data-modeling).

You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model) section of the Prisma documentation.
You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/orm/prisma-schema/data-model) section of the Prisma documentation.

</PrismaOutlinks>
4 changes: 2 additions & 2 deletions content/02-datamodeling/05-correctness-constraints.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -110,9 +110,9 @@ But there are also ways in which the very structure of a table can lead to incon

<PrismaOutlinks>

If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/concepts/overview/what-is-prisma/data-modeling).
If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/orm/overview/introduction/data-modeling).

You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model) section of the Prisma documentation.
You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/orm/prisma-schema/data-model) section of the Prisma documentation.

</PrismaOutlinks>

Expand Down
4 changes: 2 additions & 2 deletions content/02-datamodeling/06-making-connections.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,8 +116,8 @@ We'll come back to organizing tables in databases and in schemas within database

<PrismaOutlinks>

If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/concepts/overview/what-is-prisma/data-modeling).
If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/orm/overview/introduction/data-modeling).

You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model) section of the Prisma documentation.
You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/orm/prisma-schema/data-model) section of the Prisma documentation.

</PrismaOutlinks>
10 changes: 5 additions & 5 deletions content/02-datamodeling/08-functional-units.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ But databases are, by definition, very good at processing and manipulating infor

<PrismaOutlinks>

Find out [how to use functions with Prisma](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model#using-functions) in the Prisma documentation.
Find out [how to use functions with Prisma](https://www.prisma.io/docs/orm/prisma-schema/data-model/models#using-functions) in the Prisma documentation.

</PrismaOutlinks>

Expand Down Expand Up @@ -93,7 +93,7 @@ CREATE TABLE lots (

<PrismaOutlinks>

If you're using Prisma, our documentation covers the equivalent method of [defining default values for your fields](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model#defining-a-default-value). Prisma Client also supports [aggregation](https://www.prisma.io/docs/concepts/components/prisma-client/aggregation-grouping-summarizing), which allows you to perform count, average, and similar operations on data without separate storage.
If you're using Prisma, our documentation covers the equivalent method of [defining default values for your fields](https://www.prisma.io/docs/orm/prisma-schema/data-model/models#defining-a-default-value). Prisma Client also supports [aggregation](https://www.prisma.io/docs/orm/prisma-client/queries/aggregation-grouping-summarizing), which allows you to perform count, average, and similar operations on data without separate storage.

</PrismaOutlinks>

Expand Down Expand Up @@ -179,7 +179,7 @@ The trigger-action-trigger-action call stack can become arbitrarily long, althou

<PrismaOutlinks>

In Prisma Client, you can achieve similar results with TypeScript at the client level instead of SQL by using [middleware](https://www.prisma.io/docs/concepts/components/prisma-client/middleware). Middleware allows you to perform an action before and after every query (e.g., turn a `delete` query into a "soft" delete which toggles a record's visibility instead).
In Prisma Client, you can achieve similar results with TypeScript at the client level instead of SQL by using [middleware](https://www.prisma.io/docs/orm/prisma-client/client-extensions/middleware). Middleware allows you to perform an action before and after every query (e.g., turn a `delete` query into a "soft" delete which toggles a record's visibility instead).

</PrismaOutlinks>

Expand All @@ -191,9 +191,9 @@ Programmability is an unjustly overlooked feature of relational databases. There

<PrismaOutlinks>

If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/concepts/overview/what-is-prisma/data-modeling).
If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/orm/overview/introduction/data-modeling).

You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model) section of the Prisma documentation.
You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/orm/prisma-schema/data-model) section of the Prisma documentation.

</PrismaOutlinks>

Expand Down
4 changes: 2 additions & 2 deletions content/02-datamodeling/12-in-vivo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -99,8 +99,8 @@ The idea of "federated" architectures derives from the dual form of government w

<PrismaOutlinks>

If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/concepts/overview/what-is-prisma/data-modeling).
If you want to learn more about what data modeling means in the context of Prisma, visit our conceptual page on [data modeling](https://www.prisma.io/docs/orm/overview/introduction/data-modeling).

You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/concepts/components/prisma-schema/data-model) section of the Prisma documentation.
You can also learn about the specific data model component of a Prisma schema in the [data model](https://www.prisma.io/docs/orm/prisma-schema/data-model) section of the Prisma documentation.

</PrismaOutlinks>
Loading

1 comment on commit 5c7ac57

@vercel
Copy link

@vercel vercel bot commented on 5c7ac57 Dec 15, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

dataguide – ./

dataguide-prisma.vercel.app
dataguide-git-main-prisma.vercel.app
dataguide.vercel.app

Please sign in to comment.