Ticket #480 (new enhancement)
Opened 13 months ago
Clarify differences between "account" and "name" in "goracle" and "oracle" backends
|Reported by:||anon||Owned by:||ahu|
|Severity:||normal||Keywords:||documentation oracle goracle supermaster supermasters|
Section 2.1, "Supermaster automatic provisioning of slaves" in the documentation states:
"So, to benefit from this feature, a backend needs to know about the IP address of the supermaster, and how PDNS will be listed in the set of NS records remotely, and the 'account' name of your supermaster. There is no need to fill the account name out but it does help keep track of where a domain comes from."
But in section 4., "Oracle backend", no mention is made of the "account" column; rather, there is a "name" column instead. The documentation in section 2.1 should explicitly mention that.
To make matters even more confusing, the section 3.3 "Oracle specifics" does not explicitly state that this refers to the "goracle" backend; for someone perusing the documentation as a reference manual, rather than a cover-to-cover read, this can be misleading, especially if that person or persons are trying to configure pdns for the first time.
In general, a distinction between "goracle" and "oracle" backends should be made very clear everywhere each is discussed, as it is unclear to new users that these are two completely different backends with different requirements.
The documentation should not assume one understands the finer points of operating a pdns server, nor that one's powers of inference are indeed great.