[DOCS-1283] Clarify and cleanup system specific installation instructions Created: 21/Mar/13  Updated: 30/Oct/23  Resolved: 02/Jul/14

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: mongodb-2.4
Fix Version/s: Server_Docs_20231030

Type: Improvement Priority: Major - P3
Reporter: Daniel Pasette (Inactive) Assignee: Ernie Hershey
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 10 years, 47 weeks, 1 day ago

 Description   

Please work with Sam to make some clarifying changes to all the linux variant installation pages.



 Comments   
Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: v2.2
https://github.com/mongodb/docs/commit/f59acd4ddbac61bf79aadd2ea9329b50b1533c1f

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: v2.2
https://github.com/mongodb/docs/commit/f59acd4ddbac61bf79aadd2ea9329b50b1533c1f

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: v2.2
https://github.com/mongodb/docs/commit/f59acd4ddbac61bf79aadd2ea9329b50b1533c1f

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: v2.2
https://github.com/mongodb/docs/commit/f59acd4ddbac61bf79aadd2ea9329b50b1533c1f

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: v2.2
https://github.com/mongodb/docs/commit/f59acd4ddbac61bf79aadd2ea9329b50b1533c1f

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: v2.2
https://github.com/mongodb/docs/commit/f59acd4ddbac61bf79aadd2ea9329b50b1533c1f

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: v2.2
https://github.com/mongodb/docs/commit/f59acd4ddbac61bf79aadd2ea9329b50b1533c1f

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/deadeb46d35aff8d4675b5db7ce6735a59fdc8b2

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/deadeb46d35aff8d4675b5db7ce6735a59fdc8b2

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/deadeb46d35aff8d4675b5db7ce6735a59fdc8b2

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/deadeb46d35aff8d4675b5db7ce6735a59fdc8b2

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/deadeb46d35aff8d4675b5db7ce6735a59fdc8b2

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/deadeb46d35aff8d4675b5db7ce6735a59fdc8b2

Comment by auto [ 26/Mar/13 ]

Author:

{u'date': u'2013-03-25T20:37:25Z', u'name': u'Ernie Hershey', u'email': u'ernie.hershey@10gen.com'}

Message: DOCS-1283 Clarify and cleanup system specific installation instructions

DOCS-1283 Add 'Although'

(to clarify distinction between our packages and Ubuntu packages)
1) Add "although" to first paragraph on Ubuntu page

DOCS-1283 Clarify Debian/Ubuntu note

(Rewording to make the relevance of the note clearer.)
2) Clarify note on Debian page about applying to Ubuntu

DOCS-1283 Remove vague "See Also" in Synopsis

(other install pages seem to serve the same purpose)
3) Remove equivalent text across the pages by "See Also" - "The
documentation of following related processes and concepts."

DOCS-1283 Remove confusing production sentence

4) Remove "Use this for production deployments." which made more sense
when multiple packages were on the page.

DOCS-1283 Clarify package conflict wording.

DOCS-1283 Rewording package descriptions

Trying to make it clearer which package is which.

your release of Ubuntu may provide -> provided by Ubuntu

change text for other installation tutorials to a See: header

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/deadeb46d35aff8d4675b5db7ce6735a59fdc8b2

Comment by Ernie Hershey [ 25/Mar/13 ]

Items 1-4 are in this pull request:

https://github.com/mongodb/docs/pull/785

#5 we should discuss again since I think that section makes sense after looking at it more.
#6 is on the large side so I'll do separately.

Comment by Ernie Hershey [ 21/Mar/13 ]

Pages to update:

http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/#manage-installed-versions
http://docs.mongodb.org/manual/tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux/#manage-installed-versions
http://docs.mongodb.org/manual/tutorial/install-mongodb-on-debian/#install-debian-version-pinning

Notes from conversations this morning:

1) Add "although" to first paragraph on Ubuntu page
2) Clarify note on Debian page about applying to Ubuntu
3) Remove equivalent text across the pages by "See Also" - "The documentation of following related processes and concepts."
4) Remove "Use this for production deployments." which made more sense when multiple packages were on the page.
5) Remove "Using MongoDB" section
6) Add info on at least:

We should make sure to backport to 2.2

Generated at Thu Feb 08 07:40:40 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.