Skip to content

Commit 852949e

Browse files
committed
Fix some spellos, grammos, and term linking problems
1 parent 9ae2fa4 commit 852949e

File tree

1 file changed

+59
-59
lines changed

1 file changed

+59
-59
lines changed

source/reference/glossary.txt

Lines changed: 59 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,11 @@ Glossary
4141

4242
document
4343
A record in a MongoDB collection, and the basic unit of data
44-
in MongoDB. Documents are analogous to JSON object, but exist in
45-
the Database in a more type-rich format known as :term:`BSON`.
44+
in MongoDB. Documents are analogous to JSON objects, but exist in
45+
the database in a more type-rich format known as :term:`BSON`.
4646

4747
field
48-
A name-value pair in a term:`document`. Documents have zero
48+
A name-value pair in a :term:`document <document>`. Documents have zero
4949
or more fields. Fields are analogous to columns in relational
5050
databases.
5151

@@ -58,17 +58,11 @@ Glossary
5858
collection
5959
A namespace within a database for containing :term:`documents <document>`.
6060
Collections do not enforce a schema, but they are otherwise
61-
mostly analogous to RDBMS tables.
62-
63-
map-reduce
64-
A paradigm from functional programming used to implement aggregation
65-
in a number of popular database servers. MongoDB uses map-reduce
66-
in a command called :dbcommand:`mapReduce` to provide basic
67-
map-reduce style aggregation.
61+
mostly analogous to :term:`RDBMS` tables.
6862

6963
$cmd
7064
A virtual :term:`collection` that exposes :term:`MongoDB`'s
71-
term:`database commands <database command>`.
65+
:term:`database commands <database command>`.
7266

7367
JSON
7468
JavaScript Object Notation. A human-readable, plain text format
@@ -95,14 +89,13 @@ Glossary
9589
replication and automated failover. MongoDB's recommended
9690
replication strategy.
9791

98-
.. seealso:: :term:`replication`, ":doc:`/replication`" and
99-
":doc:`/core/replication`."
92+
.. seealso:: ":doc:`/replication`" and ":doc:`/core/replication`."
10093

10194
replication
10295
A feature allowing multiple database servers to share the same
10396
data, thereby ensuring redundancy and facilitating load balancing.
10497
MongoDB supports two flavors of replication: master-slave replication
105-
and replica sets
98+
and replica sets.
10699

107100
.. seealso:: :term:`replica set`, :term:`sharding`,
108101
":doc:`/replication`." and ":doc:`/core/replication`."
@@ -142,16 +135,15 @@ Glossary
142135
cluster`.
143136

144137
mongod
145-
The program implemeting the MongoDB database server. This server
138+
The program implementing the MongoDB database server. This server
146139
typically runs as a :term:`daemon`.
147140

148141
.. seealso:: ":doc:`/reference/mongod`."
149142

150143
mongos
151144
The routing and load balancing process that
152145
acts an interface between an application and
153-
a MongoDB :term:`shard cluster`. See
154-
":doc:`/reference/mongos`" for more information.
146+
a MongoDB :term:`shard cluster`.
155147

156148
.. seealso:: ":doc:`/reference/mongos`."
157149

@@ -194,8 +186,8 @@ Glossary
194186
capped collection
195187
A fixed-sized :term:`collection <collection>`. Once they reach
196188
their fixed size, capped collections automatically overwrite
197-
their oldest entries. MongoDB's replication mechanism depends on
198-
capped collections, but developers may also use them in their
189+
their oldest entries. MongoDB's :term:`oplog` replication mechanism depends on
190+
capped collections. Developers may also use capped collections in their
199191
applications.
200192

201193
.. seealso:: The ":wiki:`Capped Collections <Capped+Collections>`" wiki page.
@@ -324,19 +316,19 @@ Glossary
324316
inserts a new document having the fields implied by the
325317
query selector and the update operation.
326318

327-
csv
319+
CSV
328320
A text-based data format consisting of comma-separated values.
329321
This format is commonly used to exchange database between relational
330-
database, since the format is well-suited to tabular data. You can
322+
databases, since the format is well-suited to tabular data. You can
331323
import CSV files using :program:`mongoimport`.
332324

333-
tsv
325+
TSV
334326
A text-based data format consisting of tab-separated values.
335327
This format is commonly used to exchange database between relational
336-
database, since the format is well-suited to tabular data. You can
337-
import CSV files using :program:`mongoimport`.
328+
databases, since the format is well-suited to tabular data. You can
329+
import TSV files using :program:`mongoimport`.
338330

339-
mime
331+
MIME
340332
"Multipurpose Internet Mail Extensions." A standard set of type
341333
and encoding definitions used to declare the encoding and type
342334
of data in multiple data storage, transmission, and email
@@ -360,7 +352,7 @@ Glossary
360352
held allows concurrent readers, but no writers.
361353

362354
config database
363-
One or three :program:`mongod` instances that store all the
355+
One of three :program:`mongod` instances that store all the
364356
metadata associated with a :term:`shard cluster`.
365357

366358
balancer
@@ -370,7 +362,7 @@ Glossary
370362
the balancer for all maintenance operations on a shard cluster.
371363

372364
fsync
373-
An system call that flushes all dirty, in-memory pages to disk. MongoDB
365+
A system call that flushes all dirty, in-memory pages to disk. MongoDB
374366
calls ``fsync()`` every 60 seconds.
375367

376368
chunk
@@ -424,9 +416,9 @@ Glossary
424416
The conventional name for a background, non-interactive
425417
process.
426418

427-
pid
428-
A process ID. On Unix-like systems, a unique integer assigned to
429-
each running process. You can use a process's PID to inspect
419+
PID
420+
A process identifier. On UNIX-like systems, a unique integer PID is assigned to
421+
each running process. You can use a PID to inspect
430422
a running process and send signals to it.
431423

432424
JSONP
@@ -435,7 +427,7 @@ Glossary
435427

436428
REST
437429
An API design pattern centered around the idea of
438-
resources and the CRUD operations that apply to them. Typically
430+
resources and the :term:`CRUD` operations that apply to them. Typically
439431
implemented over HTTP. MongoDB provides a simple HTTP REST interface
440432
that allows HTTP clients to run commands against the server.
441433

@@ -458,12 +450,12 @@ Glossary
458450
":doc:`/core/replication`."
459451

460452
_id
461-
A field containing a unique ID, typically a BSON Object ID.
462-
If not specified, this value is automatically assigned while
453+
A field containing a unique ID, typically a BSON :term:`ObjectId`.
454+
If not specified, this value is automatically assigned
463455
upon the creation of a new document. You can think of the
464456
``_id`` as the document's :term:`primary key`.
465457

466-
lvm
458+
LVM
467459
Logical volume manager. LVM is a program that abstracts disk
468460
images from physical devices, and provides a number of raw disk
469461
manipulation and snapshot capabilities useful for system
@@ -477,10 +469,10 @@ Glossary
477469
order are identical.
478470

479471
primary key
480-
A record's unique, immutable identifier. In an RDBMS, the primary
472+
A record's unique, immutable identifier. In an :term:`RDBMS`, the primary
481473
key is typically an integer stored in each row's ``id`` field.
482474
In MongoDB, the :term:`_id` field holds a document's primary
483-
key. Primary keys are usually :term:`BSON` Object IDs.
475+
key which is usually a BSON :term:`ObjectId`.
484476

485477
unique index
486478
An index that enforces uniqueness for a particular field across
@@ -496,6 +488,8 @@ Glossary
496488
operations in a database's ``system.profile`` collection. The
497489
profiler is most often used to diagnose slow queries.
498490

491+
.. seealso:: ":ref:`Monitoring Database Systems <database-profiling>`."
492+
499493
shard key
500494
In a sharded collection, a shard key is the field that MongoDB
501495
uses to distribute documents among members of the
@@ -516,14 +510,14 @@ Glossary
516510
pre-splitting
517511
When deploying a :term:`shard cluster`, it is sometimes
518512
necessary to expedite the initial distribution of documents
519-
among shards, by manually dividing the collection into chunks.
513+
among shards by manually dividing the collection into chunks.
520514
In this case, you pre-split the chunks instead of waiting for
521-
MongoDB to create splits.
515+
the MongoDB :term:`balancer` to create splits.
522516

523517
SSD
524518
Solid State Disk. A high-performance disk drive that uses solid
525-
state elecronics, as opposed to rotating platters and a head, for
526-
persistence.
519+
state electronics for persistence, as opposed to the rotating platters
520+
and movable read/write heads used by traditional mechanical hard drives.
527521

528522
resident memory
529523
The subset of an application's memory currently stored in
@@ -535,7 +529,7 @@ Glossary
535529
disk an in physical RAM.
536530

537531
pipe
538-
A communication channel UNIX allowing independent processes
532+
A communication channel in UNIX-like systems allowing independent processes
539533
to send and receive data. In the UNIX shell, piped operations
540534
allow users to direct the output of one command into the input
541535
of another.
@@ -546,7 +540,7 @@ Glossary
546540
support the number of hosts on the contemporary Internet.
547541

548542
draining
549-
The process of removing, or "shedding" :term:`chunks <chunk>`
543+
The process of removing or "shedding" :term:`chunks <chunk>`
550544
from one :term:`shard` to another. Administrators must drain
551545
shards before removing them from the cluster.
552546

@@ -586,7 +580,7 @@ Glossary
586580
nodes have :term:`eventual consistency`.
587581

588582
write concern
589-
A setting on writes to MongoDB that allows the use to specify,
583+
A setting on writes to MongoDB that allows the user to specify,
590584
how the database will handle a write operation before
591585
returning. This often determines how many :term:`replica set`
592586
members should propagate a write before returning.
@@ -595,14 +589,14 @@ Glossary
595589

596590
priority
597591
In the context of :term:`replica sets <replica set>`, priority
598-
is a configurable values that help determine which nodes in
592+
is a configurable value that helps determine which nodes in
599593
a replica set are most likely to become :term:`primary`.
600594

601595
.. seealso:: ":ref:`Replica Set Node Priority
602596
<replica-set-node-priority>`"
603597

604598
election
605-
In the context of :term:`replica sets <replica set>`, election
599+
In the context of :term:`replica sets <replica set>`, an election
606600
is the process by which members of a replica set select
607601
primary nodes on startup and in the event of failures.
608602

@@ -637,7 +631,7 @@ Glossary
637631

638632
read preference
639633
A setting on the MongoDB :doc:`drivers </applications/drivers>`
640-
that determines where how the clients direct read
634+
that determines how the clients direct read
641635
operations. Read preference affects all replica sets including
642636
shards. By default, drivers direct all reads to :term:`primary`
643637
nodes for :term:`strict consistency`. However, you may also
@@ -653,7 +647,7 @@ Glossary
653647
to keep replication lag as small as possible.
654648

655649
driver
656-
A client implementing the communcation protocol required for talking
650+
A client implementing the communication protocol required for talking
657651
to a server. The MongoDB drivers provide language-idiomatic
658652
methods for interfacing with MongoDB.
659653

@@ -686,7 +680,7 @@ Glossary
686680
clients may use to issue data-center aware operations.
687681

688682
recovering
689-
A :term:`replica set` memeber status indicating that a member
683+
A :term:`replica set` member status indicating that a member
690684
is synchronizing or re-synchronizing its data
691685
from the primary node. Recovering nodes are unavailable for reads.
692686

@@ -709,21 +703,27 @@ Glossary
709703

710704
.. STUB ":doc:`/core/map-reduce`"
711705

706+
RDBMS
707+
Relational Database Management System. A database management system based on the relational model, typically using :term:`SQL` as the query language.
708+
712709
SQL
713-
Standard Query Language. SQL is the language used for all
714-
interactions with a relational database. Provides read, write,
715-
and data aggregation capabilities Often, ``SQL`` is often used
716-
as a metonym for relational databases.
710+
Structured Query Language (SQL) is a common special-purpose programming
711+
language used for interaction with a relational database including access
712+
control as well as inserting, updating, querying, and deleting data.
713+
There are some similar elements in the basic SQL syntax supported by different
714+
database vendors, but most implementations have their own dialects,
715+
data types, and interpretations of proposed SQL standards.
716+
Complex SQL is generally not directly portable between major :term:`RDBMS` products.
717+
Often, ``SQL`` is often used as a metonym for relational databases.
717718

718719
aggregation
719720
Any of a variety of operations that reduce and summarize large
720721
sets of data. SQL's ``GROUP`` and MongoDB's map-reduce are two
721722
examples of aggregation functions.
722723

723724
aggregation framework
724-
An aggregation command that provides a large set of operators
725-
resembling the MongoDB query language and that's used to perform
726-
common aggregations.
725+
The MongoDB aggregation framework provides a means to calculate
726+
aggregate values without having to use :term:`map-reduce`.
727727

728728
.. seealso:: ":doc:`/applications/aggregation`."
729729

@@ -749,8 +749,8 @@ Glossary
749749
of any database.
750750

751751
JavaScript
752-
An popular scripting language original designed for web browers.
753-
The MongoDB's shell, and certain server-side functions, use
752+
A popular scripting language original designed for web browsers.
753+
The MongoDB shell and certain server-side functions use
754754
a JavaScript interpreter.
755755

756756
idempotent
@@ -797,10 +797,10 @@ Glossary
797797
TTL
798798
Stands for "time to live," and represents an expiration time or
799799
period for a given piece of information to remain in a cache or
800-
other temporary storage system before deleted or aged out.
800+
other temporary storage system before being deleted or aged out.
801801

802802
ObjectId
803803
A special 12-byte :term:`BSON` type that has a high probability
804804
of being unique when generated. The most significant digits in
805805
an ObjectId represent the time when the Object. MongoDB uses
806-
ObjectId values as the default values for :term:`_id` field.
806+
ObjectId values as the default values for :term:`_id` fields.

0 commit comments

Comments
 (0)