-
Type:
Improvement
-
Status: Done
-
Priority:
Critical
-
Resolution: Fixed
-
Affects Version/s: 7.0.0
-
Fix Version/s: 7.0.0
-
Component/s: documentation, ease of use, tech-debt
-
Labels:
-
Epic Link:
-
Story Points:1
At present, most DS doc examples use FQDNs. This probably arose because:
- The best practice for setting up replicationĀ for real is to use FQDNs.
- Sometimes FQDNs help you understand the instance, e.g. rs.example.com vs. ds-only.example.com vs. proxy.example.com.
- Server IDs weren't strings and were useless to distinguish one instance from another.
This is annoying in practice. Either you fake FQDNs inĀ /etc/hosts just to use the examples as is, or you edit every example after copying and before pasting. The Getting Started guide drops FQDNs in favor of localhost for that reason.
Assuming our readers are not limited to internal FR developers who use DS all day long, and assuming the common case when reading the docs is trying something out in dev on one's laptop, it would be good to favor usability by using localhost as the default, and distinguish by port numbers, comments in the examples, and server IDs where possible.
- relates to
-
OPENDJ-6702 Doc tests: Run tests on Docker images
-
- Done
-
-
OPENDJ-6456 For keystore/truststore path default to instance root if available
-
- Dev backlog
-