[DOCS-1869] Updates/ fixes/ restores to the sharding docs Created: 30/Aug/13  Updated: 11/Jan/17  Resolved: 30/Aug/13

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: 01112017-cleanup

Type: Improvement Priority: Critical - P2
Reporter: Nicholas Tang Assignee: Sam Kleinman (Inactive)
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
related to DOCS-1871 Increase Clarification about Challeng... Closed
Participants:
Days since reply: 10 years, 24 weeks, 5 days ago

 Description   

Just to summarize my email so it's not lost, two related problems w/ the sharding docs:

  1. We now "hide" a bunch of the tutorials, some of which are critical to users. If you go here: http://docs.mongodb.org/manual/administration/sharded-clusters/, we only show 3 maintenance tutorials. If you go here: http://docs.mongodb.org/manual/administration/sharded-cluster-maintenance/ we show 11. That means that unless you know that you need to click through to the heading to see them all, you'll never see or find the 8 remaining tutorials, some of which are really critically important.
  2. Along similar lines, we used to have some advisories/ admonishments about moving config servers - specifically, that it will require complete cluster downtime. It can be avoided by using some sort of indirection - most simply, by using logical CNAMEs to point to the actual hostnames, so that you can change the hostnames without changing the connection string. That should be called out repeatedly and with great emphasis in the docs, since the alternative is restarting your entire cluster every time you move one. I'd also add that note to the Production Notes.

It's critical that we get those fixes into the docs ASAP, imho.



 Comments   
Comment by auto [ 30/Aug/13 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-1869 adding document to tutorial landing page
Branch: master
https://github.com/mongodb/docs/commit/e8551f6c2a006280c8397c401c54ce9e0e36c9f6

Comment by auto [ 30/Aug/13 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-1869: adding clarification about structure of tutorials.
Branch: master
https://github.com/mongodb/docs/commit/88d12edf2de90e24b06af728f4321c0b238cbd79

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