SERVER-121793: prettier-format README files (#49712)

GitOrigin-RevId: 3206b35683899266c7dcbee2d2a5bd27dd57b541
This commit is contained in:
Steve McClure 2026-03-17 18:05:35 -04:00 committed by MongoDB Bot
parent 87dede76a6
commit 3634a70cf5
6 changed files with 104 additions and 102 deletions

View File

@ -8,8 +8,6 @@
*.json
*.wxs
README
# Ignore files that fail after format
jstests/noPassthrough/js_exceptions.js
jstests/noPassthrough/network/client_metadata_slowlog.js

View File

@ -4,25 +4,25 @@ Welcome to MongoDB!
COMPONENTS
mongod - The database server.
mongos - Sharding router.
mongo - The database shell (uses interactive javascript).
mongod - The database server.
mongos - Sharding router.
mongo - The database shell (uses interactive javascript).
UTILITIES
install_compass - Installs MongoDB Compass for your platform.
install_compass - Installs MongoDB Compass for your platform.
BUILDING
See docs/building.md.
See docs/building.md.
RUNNING
For command line options invoke:
For command line options invoke:
$ ./mongod --help
To run a single server database:
To run a single server database:
$ sudo mkdir -p /data/db
$ ./mongod
@ -33,56 +33,55 @@ RUNNING
INSTALLING COMPASS
You can install compass using the install_compass script packaged with MongoDB:
You can install compass using the install_compass script packaged with MongoDB:
$ ./install_compass
This will download the appropriate MongoDB Compass package for your platform
and install it.
This will download the appropriate MongoDB Compass package for your platform
and install it.
DRIVERS
Client drivers for most programming languages are available at
https://docs.mongodb.com/manual/applications/drivers/. Use the shell
("mongo") for administrative tasks.
Client drivers for most programming languages are available at
https://docs.mongodb.com/manual/applications/drivers/. Use the shell
("mongo") for administrative tasks.
BUG REPORTS
See https://github.com/mongodb/mongo/wiki/Submit-Bug-Reports.
See https://github.com/mongodb/mongo/wiki/Submit-Bug-Reports.
PACKAGING
Packages are created dynamically by the packager.py script located in the
buildscripts directory. This will generate RPM and Debian packages.
Packages are created dynamically by the packager.py script located in the
buildscripts directory. This will generate RPM and Debian packages.
DOCUMENTATION
https://docs.mongodb.com/manual/
https://docs.mongodb.com/manual/
CLOUD HOSTED MONGODB
https://www.mongodb.com/cloud/atlas
https://www.mongodb.com/cloud/atlas
FORUMS
https://community.mongodb.com
https://community.mongodb.com
A forum for technical questions about using MongoDB.
https://community.mongodb.com/c/server-dev
https://community.mongodb.com/c/server-dev
A forum for technical questions about building and developing MongoDB.
LEARN MONGODB
https://university.mongodb.com/
https://university.mongodb.com/
LICENSE
MongoDB is free and open-source. Versions released prior to October 16,
2018 are published under the AGPL. All versions released after October
16, 2018, including patch fixes for prior versions, are published under
the Server Side Public License (SSPL) v1. See individual files for
details which will specify the license applicable to each file. Files
subject to the SSPL will be noted in their headers.
MongoDB is free and open-source. Versions released prior to October 16,
2018 are published under the AGPL. All versions released after October
16, 2018, including patch fixes for prior versions, are published under
the Server Side Public License (SSPL) v1. See individual files for
details which will specify the license applicable to each file. Files
subject to the SSPL will be noted in their headers.

View File

@ -1,7 +1,7 @@
This directory contains two scripts.
mkcert.py - A python3 script using PyOpenSSL to generate the majority of
X509 certificates based on the contents of certs.yml
X509 certificates based on the contents of certs.yml
mkcrl.sh - Certificate Revocation List generators.
mkcert.py may be invoked without any arguments, in which case it will regenerate ALL certificates.
@ -10,6 +10,7 @@ If any of these certificates represent CAs, then all dependent certificates will
cert.yml format:
```
global:
output_path: '.../' # Required, default output path for all certs in this file.
Subject: {...} # Optional, name entities to use for all cert, overridden by values in cert entries.
@ -65,3 +66,4 @@ certs:
- {role: readWrite, db: test1}
- {role: read, db: test2}
- mongoClusterMembership: clusterName
```

View File

@ -3,5 +3,3 @@
This is the C++ implementation. Implementations which translate BSON<->JSON
are available for most languages at bsonspec.org.

View File

@ -10,8 +10,11 @@ This directory contains:
To run:
```
python x509/mkcert.py CONFIG [--mkcrl | --no-mkcrl] [-o OUTPUT] [--static-dir STATIC_DIR]
[--dry-run] [certs ...]
```
- CONFIG is the path to the JSON file specifying a list of certificates, required
- OUTPUT is the path to a directory where the generated items will be stored, default .
- STATIC_DIR is the path where signing keys needed by certificates are stored, default x509/static
@ -38,6 +41,7 @@ Future work:
Certificate definition format:
```
{
"global": {
# Optional, default value to use for Key1 for all certs, overridden by values in cert entries.
@ -103,3 +107,4 @@ Certificate definition format:
...
]
}
```