DOCS: mentions `{ no_ns: 'true' }` domain modifier

[SukkaW]

Currently, the docs don't mention no_ns at all.

My use case:

• I use Namesilo as my registrar, which DNSControl does not support (which is fine, name server updates are rare, and I can always do this manually)
  • Thus, I use NewRegistrar('none').
• I use Vercel DNS.
  • Vercel DNS doesn't give you any control over the apex NS record.
  • You can't add more NS records at the apex.
  • You can't even see the default apex NS records (including the ones you are actually using) from their listing API.
  • Thus, when implementing Vercel Providers, I deliberately return an empty array from the GetNameservers method (just like what the Gandi provider does)
  • Thus, I do not have any nameserver records under my domain, and DNSControl prints a warning: Skipping registrar "none": No nameservers declared for domain "example.com". Add {no_ns:'true'} to force
• I use Cloudflare via Partial Setup, a.k.a. CNAME setup
  • With this setup, you still use Cloudflare DNS to specify the CDN pull zone. I use example.com!cloudflare (DNSControl split-horizon DNS) to manage CDN pull zone config via DNSControl
  • With this setup, Cloudflare API does not return any nameservers
  • Thus, Cloudflare Provider's GetNameservers method also returns an empty array
  • Thus, I do not have any nameserver records under my example.com!cloudflare zone, and DNSControl also prints a warning: Skipping registrar "none": No nameservers declared for domain "example.com". Add {no_ns:'true'} to force

I am only able to figure out what no_ns is after digging into the source code. There might be others who are not as technically advanced as me, and can't figure out what is happening.

Probably should just document this?

[tlimoncelli]

Wow! I hadn't realized this wasn't documented! Yes, this definitely needs to be documented. Perhaps (separately or as part of this) a page about what to do when you don't need have a registrar?

[tlimoncelli]

CC @cafferata

[fukawi2]

I am only able to figure out what no_ns is after digging into the source code.

Any hints in the mean time until this is documented? 😄 🙏

[tlimoncelli]

Hello friend!

The difficulty I'm having is trying to remember what it does well enough to explain it :-)

I'll try to get to it this week. I'm pretty busy with my day job.

[fukawi2]

Haha, I know that feeling. No problem, it's not urgent :)