From 1db40a44025a4d688f172142e73d28b097a74173 Mon Sep 17 00:00:00 2001 From: kay Date: Wed, 16 Jan 2013 20:54:27 -0500 Subject: [PATCH 1/2] DOCS-999 draft reorg landing page --- source/index.txt | 205 +++++++---------------- themes/mongodb/static/mongodb-docs.css_t | 13 ++ 2 files changed, 74 insertions(+), 144 deletions(-) diff --git a/source/index.txt b/source/index.txt index 3dfef358f6c..27e2fc05681 100644 --- a/source/index.txt +++ b/source/index.txt @@ -6,155 +6,72 @@ The MongoDB Manual .. default-domain:: mongodb -Welcome to the MongoDB Manual! The Manual begins by introducing -MongoDB and continues to describe the query language, operational -considerations and procedures, administration, among other topics in -addition to a thorough reference. - -This manual is under constant development, and will soon replace the -existing :ref:`MongoDB Wiki `. See the ":doc:`/about`" -page for an overview of the MongoDB Documentation project. For now, -documentation resources coexist and link to one another. As you -explore the manual, expect to move between documentation sites. - -Getting Started ---------------- - -MongoDB is an open-source, document-oriented database designed for -ease of development and scalability, with particular emphasis on -Internet applications and infrastructure. If you're new to -MongoDB, begin with the following resources: - -- :doc:`Installing MongoDB ` -- :doc:`The MongoDB Tutorial ` -- :doc:`Frequently Asked Questions ` - -If you're familiar with database systems that use SQL, consider the -following documents, which compare common MongoDB conventions and -operations with their SQL equivalents: +MongoDB is an open-source, document-oriented database designed for ease +of development and scalability. -- :doc:`/reference/sql-comparison` -- :doc:`/reference/sql-aggregation-comparison` +.. list-table:: -MongoDB has an :wiki:`active community `. You'll get a -quick response to any question posted to the `MongoDB User Mailing List`_. + * - **Getting Started** -.. _`MongoDB User Mailing List`: https://groups.google.com/forum/?fromgroups#!forum/mongodb-user + :doc:`/installation` -MongoDB... ----------- + :doc:`Introduction to MongoDB ` -.. hlist:: - :columns: 2 + :doc:`MongoDB Fundamentals ` - - **For Developers** + :doc:`/mongo` + + :doc:`Tutorials ` - If you're new to MongoDB, consider the :doc:`/installation` - document, the :doc:`/faq` section and particularly the - :doc:`developer FAQs - `. The :doc:`/applications/drivers` page lists the - client libraries which all provide basic introductory - tutorials. Nevertheless, MongoDB users should have a basic - understanding several core concepts, including: - - - :doc:`/core/document` - - :doc:`/core/read-operations` - - :doc:`/core/write-operations` - - Once you have selected a programming :doc:`language and driver - `, become familiar with the core - :doc:`/crud` and :doc:`/applications` documents, in particular: - - - :doc:`/applications/create`, - - :doc:`/applications/read`, - - :doc:`/applications/update`, and - - :doc:`/applications/delete`. - - As you use MongoDB more you should also be learn about - :doc:`Indexing `. Many users will also find MongoDB's - :doc:`data aggregation ` useful. Finally, the - :doc:`use case ` and :doc:`tutorials ` - documents provide examples and outline common processes and - practices. - - - **For Administrators** - - If you're administering MongoDB, you'll need to know at least the - basics of :doc:`querying ` MongoDB and :wiki:`using - the shell `. You can - then the Manual's :doc:`administration ` - section, beginning with the :doc:`configuration - ` document. - - Most deployments consist of a single replica set. Scaling the - database horizontally on existing hardware usually involves - sharding, consider the documentation of these deployment options: - - - :doc:`Replication ` - - :doc:`Sharding ` - - As you begin deploying MongoDB in production environments, - familiarize yourself with the :ref:`Administration Tutorials - ` section and the following topics: - - - :doc:`Security ` - - :doc:`Backups ` - - :doc:`Monitoring ` - - :doc:`Hardware and System Settings ` - -Reference ---------- - -This manual features a detailed reference, including: a JavaScript -method reference, detailed documentation of all operators in the -MongoDB query language, manual pages for all MongoDB tools and -binaries, a reference of all database commands, and full glossary and -topic index. - -- :doc:`/reference/javascript` -- :doc:`/reference/operators` -- :ref:`MongoDB Manual Pages ` -- :doc:`/reference/commands` -- :doc:`/reference/glossary` -- :ref:`MongoDB Manual Topic Index ` - -Also consider the full :doc:`outline of the MongoDB Manual -`, and an index of all :doc:`MongoDB tutorials `. - -.. _mongodb-wiki: - -MongoDB Wiki ------------- - -This manual will eventually replace the :wiki:`MongoDB Wiki <>`. Until -then, you'll have to use both to get the best information on -MongoDB. The following pages from the wiki are especially useful: - -.. hlist:: - :columns: 1 + - **Developers** - - **Getting Started** - - .. hlist:: - :columns: 1 - - - :wiki:`Introduction` - - :wiki:`Developer Introduction ` - - `Downloads `_ - - - :wiki:`Community` and :wiki:`Ecosystem ` - - .. hlist:: - :columns: 2 - - - `10gen `_ - - `MongoDB Events `_ - - `Planet MongoDB `_ - - :wiki:`MongoDB Masters ` - - `Slides and Video `_ - - :wiki:`Hosting Center ` - - :wiki:`Windows` - - `MongoDB Monitoring Service `_ (`docs `_) - - :wiki:`Administrative Interfaces ` - - :wiki:`International Documentation ` - - `MongoDB Books `_ + :doc:`Database Operations` + + :doc:`Aggregation ` + + :doc:`/indexes` + + :doc:`/applications` + + - **Administrators** + + :doc:`/administration` + + :doc:`/replication` + + :doc:`/sharding` + + :doc:`/security` + + - **Reference** + + :doc:`/reference` + + :doc:`JavaScript Methods ` + + :doc:`Operators ` + + :doc:`Commands ` + + :doc:`/reference/glossary` + +Community +~~~~~~~~~ + +MongoDB has an :wiki:`active community `. You'll get a quick +response to MongoDB questions (i.e. questions tagged ``mongodb``) posted +to `StackOverflow`_. + +.. _`StackOverflow`: http://stackoverflow.com/questions/tagged/mongodb + +Other Resources +~~~~~~~~~~~~~~~ + +The following resources provide additional information: + +- `10gen `_ +- `MongoDB Events `_ +- `Planet MongoDB `_ +- `Slides and Video `_ +- `MongoDB Monitoring Service `_ (`MMS Help docs `_) +- `MongoDB Books `_ diff --git a/themes/mongodb/static/mongodb-docs.css_t b/themes/mongodb/static/mongodb-docs.css_t index dc4bc101714..a9c7e441505 100644 --- a/themes/mongodb/static/mongodb-docs.css_t +++ b/themes/mongodb/static/mongodb-docs.css_t @@ -321,6 +321,19 @@ div td pre { table.docutils td { padding: 8px; } +div#the-mongodb-manual.section table.docutils td { + border-bottom: none; + padding-left: 25px; + padding-right: 25px; +} + +div#the-mongodb-manual.section table.docutils { + margin: auto; + padding-top: 5px; + padding-bottom: 5px; + background-color: #F3F4EB; +} + table.docutils>thead th.head { padding-top: 5px; padding-bottom: 5px; From c5186309f71e8fe66f73130e1720b3faac1e2037 Mon Sep 17 00:00:00 2001 From: kay Date: Thu, 17 Jan 2013 13:23:25 -0500 Subject: [PATCH 2/2] DOCS-999 reorg landing page w table and Stack Overflow --- source/index.txt | 75 ++++++++++++++---------- themes/mongodb/static/mongodb-docs.css_t | 44 ++++++++++---- 2 files changed, 79 insertions(+), 40 deletions(-) diff --git a/source/index.txt b/source/index.txt index 27e2fc05681..b4a2e466bb6 100644 --- a/source/index.txt +++ b/source/index.txt @@ -6,66 +6,81 @@ The MongoDB Manual .. default-domain:: mongodb -MongoDB is an open-source, document-oriented database designed for ease -of development and scalability. -.. list-table:: - - * - **Getting Started** - - :doc:`/installation` +Welcome to the MongoDB Manual! MongoDB is an open-source, +document-oriented database designed for ease of development and +scalability.The Manual begins by introducing MongoDB and continues to +describe the query language, operational considerations and procedures, +administration, among other topics in addition to a thorough reference. +This manual is under constant development. See the :doc:`/about` for +more information on the MongoDB Documentation project. - :doc:`Introduction to MongoDB ` +.. list-table:: + :header-rows: 1 + :class: index-table - :doc:`MongoDB Fundamentals ` + * - Getting Started + - Developers + - Administrators + - Reference + + * - :doc:`/installation` - :doc:`/mongo` + :doc:`First Steps ` + + :doc:`MongoDB Shell ` :doc:`Tutorials ` - - **Developers** - - :doc:`Database Operations` + - :doc:`Database Operations` :doc:`Aggregation ` :doc:`/indexes` - :doc:`/applications` + :doc:`Develop with MongoDB` - - **Administrators** + - :doc:`Operations ` - :doc:`/administration` + :doc:`Replica Sets ` - :doc:`/replication` - - :doc:`/sharding` + :doc:`Sharded Clusters` - :doc:`/security` + :doc:`MongoDB Security ` - - **Reference** + - :doc:`Shell Methods ` - :doc:`/reference` + :doc:`Query Operators ` - :doc:`JavaScript Methods ` + :doc:`Database Commands ` - :doc:`Operators ` + :doc:`/reference/glossary` - :doc:`Commands ` + * - + - + - + - - :doc:`/reference/glossary` +If you're new to MongoDB, also consider the following resources: + +.. toctree:: + :maxdepth: 1 + + reference/sql-comparison + /faq + Complete Reference Section Community ~~~~~~~~~ MongoDB has an :wiki:`active community `. You'll get a quick response to MongoDB questions (i.e. questions tagged ``mongodb``) posted -to `StackOverflow`_. +to `Stack Overflow`_. -.. _`StackOverflow`: http://stackoverflow.com/questions/tagged/mongodb +.. _`Stack Overflow`: http://stackoverflow.com/questions/tagged/mongodb -Other Resources -~~~~~~~~~~~~~~~ +Additional Resources +~~~~~~~~~~~~~~~~~~~~ The following resources provide additional information: diff --git a/themes/mongodb/static/mongodb-docs.css_t b/themes/mongodb/static/mongodb-docs.css_t index a9c7e441505..a0678bcd565 100644 --- a/themes/mongodb/static/mongodb-docs.css_t +++ b/themes/mongodb/static/mongodb-docs.css_t @@ -320,24 +320,48 @@ div td pre { } table.docutils td { padding: 8px; } +table.docutils>thead th.head { + padding-top: 5px; + padding-bottom: 5px; + background-color: #F3F4EB; +} -div#the-mongodb-manual.section table.docutils td { +table.index-table td { + text-align: center; border-bottom: none; - padding-left: 25px; - padding-right: 25px; + border-right: 4px solid white; + padding-left: 15px; + padding-right: 15px; + padding-bottom: 0px; + padding-top: 5px; +} + +table.index-table tr.row-even td p { + line-height: 1.3em; } -div#the-mongodb-manual.section table.docutils { + +table.index-table tr.row-odd td { + text-align: center; + border-bottom: none; + border-right: none; + padding-left: 15px; + padding-right: 15px; + max-height:5px; + padding-top: 0px; +} + +table.index-table { margin: auto; - padding-top: 5px; - padding-bottom: 5px; background-color: #F3F4EB; } -table.docutils>thead th.head { - padding-top: 5px; - padding-bottom: 5px; - background-color: #F3F4EB; +table.index-table th.head { + text-align: center; + padding-top:10px; + padding-left: 15px; + padding-right: 15px; + border-bottom: none; } div#mongodb ul {