Hello Nikhil,
thanks for your quick response.
>> Note that `mkdocs.yml` gets explicitly removed while calling `make
>> dist` (see `builds/toplevel.mk`).
>
> `mkdocs serve` requires the file `mkdocs.yml` to generate the site
> and start up the server.
Yes, but...
> If we want search to be usable locally, I suggest that the file
> `mkdocs.yml` be included in the distribution, and `mkdocs serve` be
> officially documented as a method to serve the site. Of course,
> this will require Python 3 and mkdocs to be available in the
> environment.
... the automatically generated `mkdocs.yml` file doesn't work with
the tarball because it needs the `markdown` directory, which is
intentionally omitted.
How to proceed? Can the `mkdocs.yml` file perhaps be adjusted to make
searching work? Availability of a local search would be definitely a
good thing, and yes, it should also be documented how to get it.
Werner
