[asterisk-dev] New Asterisk Documentation website is available for preview

[asterisk at phreaknet.org]

On 6/20/2023 9:48 PM, Andrew Latham wrote:
> https://github.com/asterisk/documentation/pull/2 for the binding topic
>
> On Tue, Jun 20, 2023 at 7:42 PM Andrew Latham <lathama at gmail.com 
> <mailto:lathama at gmail.com>> wrote:
>
>     Read https://github.com/mkdocs/mkdocs/issues/2108 and just have to
>     say wow...
>
>     This worked for me: `mkdocs serve --dev-addr 0.0.0.00:8000`
>

Thanks, Andrew, for looking into that, and putting those PRs up. Good to 
know that option works. I think he has a point about using a third-party 
server, which is what you'd do anyways, but `mkdocs serve` as a command 
is useless if it can't bind to all interfaces. I don't even use 
containers; to look at the website, it simply has to be bound to all 
interfaces if I want to look at it in a web browser, it's that simple. 
It's very narrow minded to assume that people's workstations are also 
the server that is running XYZ workload, which for me is *never* the case.

The only other thing I can think of at the moment is that it would be 
useful to put the `mkdocs build` command in the README. But this is 
mainly for when the dynamic docs are available, so maybe I'll wait until 
that is finalized as there will probably be more instructions and 
context needed.