From 029b07ea6ddcbd23549ecea16a41dfc8faae674c Mon Sep 17 00:00:00 2001 From: Melissa Mahoney Date: Wed, 21 May 2025 16:36:38 -0400 Subject: [PATCH 1/7] Adding in intro --- source/index.txt | 52 ++++++++++++++++++++++++++++++++++-------------- 1 file changed, 37 insertions(+), 15 deletions(-) diff --git a/source/index.txt b/source/index.txt index 3f7f0a93..ef3aedee 100644 --- a/source/index.txt +++ b/source/index.txt @@ -1,5 +1,3 @@ -:template: landing -:hidefeedback: page :nav-show-all-products: true :title: Docs Home @@ -7,9 +5,9 @@ :description: Store data in flexible documents and develop applications designed to adapt and scale, backed by Atlas, a fully managed platform with always-on security and an ecosystem of tools and integrations. :canonical: https://www.mongodb.com/docs/ -===================== -MongoDB Documentation -===================== +======================= +Welcome to MongoDB Docs +======================= .. ia:: @@ -116,18 +114,42 @@ MongoDB Documentation :icon: /images/icons/ts.svg :icon-alt: TypeScript Driver icon -.. introduction:: +Welcome to the MongoDB documentation. This site contains everything you need to learn to effectively use MongoDB as an application developer or an operator. - Welcome to the official MongoDB Documentation. - Whether you’re a developer, database administrator, - or just starting your journey with MongoDB, our - documentation provides you with the information and - knowledge needed to build applications on MongoDB and - the Atlas developer data platform. +What is MongoDB? +---------------- -.. image:: /images/homepage-hero-revert.svg - :class: hero-img - :alt: Homepage illustration +MongoDB is a document-oriented, operational database built from the ground up as an alternative to the relational database for modern applications. + +Unlike relational databases, MongoDB allows developers to store rich JSON-like documents that map naturally to the objects they use in their code. + +For example, to model user objects in an application, a relational model would require multiple tables for what could be elegantly stored in MongoDB as this: + +.. code-block:: json + + { + firstname: "Bob", + lastname: "Smith", + email: "bob@smith.com", + address: { + street: "100 Main St", + city: "Anytown", + state: "MO", + zip: "11111" + } + } + +And retrieved with queries such as this: + +.. code-block:: sh + + users.find({address.zip : "11111"}) + +MongoDB also offers: + - Strong consistency with ACID transactions. + - Modern additional built-in query capabilities such as geo search, lexical search, and vector search. + - Serverless horizontal scaling with geo-aware fault tolerance across all major clouds. + - Security primitives that allow MongoDB to operate in the most demanding of enterprise environments. .. card-group:: :columns: 1 From 546127d13560c7640f264ce0915b1f040c6fcf00 Mon Sep 17 00:00:00 2001 From: Melissa Mahoney Date: Wed, 21 May 2025 16:37:22 -0400 Subject: [PATCH 2/7] adding in cards --- source/index.txt | 52 +++++++++++++++++++++++++++++------------------- 1 file changed, 32 insertions(+), 20 deletions(-) diff --git a/source/index.txt b/source/index.txt index ef3aedee..977e4a6d 100644 --- a/source/index.txt +++ b/source/index.txt @@ -151,45 +151,57 @@ MongoDB also offers: - Serverless horizontal scaling with geo-aware fault tolerance across all major clouds. - Security primitives that allow MongoDB to operate in the most demanding of enterprise environments. +.. kicker:: How this documentation is organized + .. card-group:: :columns: 1 :layout: default .. card:: - :headline: MongoDB Atlas → + :headline: Getting Started :url: https://www.mongodb.com/docs/atlas/getting-started/ - :icon: /images/technical-atlas-serverless.svg - :icon-alt: Atlas icon - Run MongoDB on a multi-cloud developer data platform that - accelerates and simplifies working with operational data. + Start here! Our Getting Started guide walks you through deploying + your first database and downloading all the tools and libraries + you need to start developing with MongoDB. .. card:: - :headline: Database Manual → - :icon: /images/technical-mdb-shell.svg - :icon-alt: MongoDB Database Manual + :headline: Development :url: https://www.mongodb.com/docs/manual/ - Learn core MongoDB concepts, including data modeling, querying - data, aggregations, sharding, and more. + Everything you need to know to write apps with MongoDB, from the basics like connecting, + CRUD, and the core query language, to advanced topics such as index + optimization and data modeling. .. card:: - :headline: Migrators, Tools, and Connectors → - :icon: /images/general-features-tools.svg - :icon-alt: Migrators, Tools, and Connectors + :headline: Management :url: https://www.mongodb.com/docs/tools-and-connectors/ - Explore tools and integrations for MongoDB, from data - visualization and development to migration and management. + Everything you need to know to administer and manage MongoDB deployments, including + provisioning, scaling, backup, monitoring, disaster recovery, security. + + .. card:: + :headline: Client Libraries + :url: https://www.mongodb.com/docs/drivers/ + + Connect application code to MongoDB with a client library in + your favorite programming language or application framework. .. card:: - :headline: Client Libraries → - :icon: /images/technical-atlas-drivers.svg - :icon-alt: Client libraries icon. + :headline: Tools :url: https://www.mongodb.com/docs/drivers/ - Connect your application to your database with one of the - official MongoDB libraries. + Explore tools and integrations to aid in both development and management, + including simplifying database management, integration, migration, and data visualization. + + .. card:: + :headline: Atlas Architecture Center + :url: https://www.mongodb.com/docs/drivers/ + + Learn best practices for designing scalable, secure, and resilient + systems using MongoDB in enterprise environments including architecture fundamentals, + MongoDB capabilities, and reference architectures. + More Ways to Learn ------------------ From d893c551435b92c43925101eb763341bbfc6d2ad Mon Sep 17 00:00:00 2001 From: Melissa Mahoney Date: Wed, 21 May 2025 16:44:25 -0400 Subject: [PATCH 3/7] add button --- source/index.txt | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/index.txt b/source/index.txt index 977e4a6d..4ce87e8d 100644 --- a/source/index.txt +++ b/source/index.txt @@ -116,6 +116,9 @@ Welcome to MongoDB Docs Welcome to the MongoDB documentation. This site contains everything you need to learn to effectively use MongoDB as an application developer or an operator. +.. button:: Get Started + :uri: https://www.mongodb.com/docs/atlas/getting-started/ + What is MongoDB? ---------------- From 2bdfa98bd9d91ef9d9e5e4539235c05088200c31 Mon Sep 17 00:00:00 2001 From: Melissa Mahoney Date: Wed, 21 May 2025 16:51:16 -0400 Subject: [PATCH 4/7] Add On this Page --- source/index.txt | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/source/index.txt b/source/index.txt index 4ce87e8d..0574cc12 100644 --- a/source/index.txt +++ b/source/index.txt @@ -114,6 +114,12 @@ Welcome to MongoDB Docs :icon: /images/icons/ts.svg :icon-alt: TypeScript Driver icon +.. contents:: On this page + :local: + :backlinks: none + :depth: 2 + :class: onecol + Welcome to the MongoDB documentation. This site contains everything you need to learn to effectively use MongoDB as an application developer or an operator. .. button:: Get Started @@ -149,10 +155,11 @@ And retrieved with queries such as this: users.find({address.zip : "11111"}) MongoDB also offers: - - Strong consistency with ACID transactions. - - Modern additional built-in query capabilities such as geo search, lexical search, and vector search. - - Serverless horizontal scaling with geo-aware fault tolerance across all major clouds. - - Security primitives that allow MongoDB to operate in the most demanding of enterprise environments. + + - Strong consistency with ACID transactions. + - Modern additional built-in query capabilities such as geo search, lexical search, and vector search. + - Serverless horizontal scaling with geo-aware fault tolerance across all major clouds. + - Security primitives that allow MongoDB to operate in the most demanding of enterprise environments. .. kicker:: How this documentation is organized From c1bbb01e1db7cf67e260fd47e0c3e7949e763c18 Mon Sep 17 00:00:00 2001 From: Melissa Mahoney Date: Wed, 21 May 2025 17:05:41 -0400 Subject: [PATCH 5/7] fix bottom buttons --- source/index.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/index.txt b/source/index.txt index 0574cc12..484dc4bc 100644 --- a/source/index.txt +++ b/source/index.txt @@ -161,7 +161,8 @@ MongoDB also offers: - Serverless horizontal scaling with geo-aware fault tolerance across all major clouds. - Security primitives that allow MongoDB to operate in the most demanding of enterprise environments. -.. kicker:: How this documentation is organized +About the Documentation +----------------------- .. card-group:: :columns: 1 From 883ca08ea58295d8a40bbd57cdda44b6ca9351ee Mon Sep 17 00:00:00 2001 From: Melissa Mahoney Date: Wed, 21 May 2025 17:08:34 -0400 Subject: [PATCH 6/7] try again --- source/index.txt | 3 --- 1 file changed, 3 deletions(-) diff --git a/source/index.txt b/source/index.txt index 484dc4bc..a86d2991 100644 --- a/source/index.txt +++ b/source/index.txt @@ -224,17 +224,14 @@ More Ways to Learn .. card:: :icon: /images/general-content-learn.svg :headline: Take Free Courses on MongoDB University - :tag: landing-bottom :url: https://learn.mongodb.com/ .. card:: :icon: /images/general-content-community.svg :headline: Join Forums and Discussions - :tag: landing-bottom :url: https://www.mongodb.com/community/ .. card:: :icon: /images/technical-mdb-devhub.svg :headline: View Developer Resources - :tag: landing-bottom :url: https://www.mongodb.com/developer/ From 5393a23a16b2c6b274c73cfa05d699bbe18b8b28 Mon Sep 17 00:00:00 2001 From: Melissa Mahoney Date: Wed, 21 May 2025 17:12:39 -0400 Subject: [PATCH 7/7] no prevnext --- source/index.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/source/index.txt b/source/index.txt index a86d2991..81889ac6 100644 --- a/source/index.txt +++ b/source/index.txt @@ -1,5 +1,6 @@ :nav-show-all-products: true :title: Docs Home +:noprevnext: .. meta:: :description: Store data in flexible documents and develop applications designed to adapt and scale, backed by Atlas, a fully managed platform with always-on security and an ecosystem of tools and integrations.