Waylan Limberg

Thanks for the report @pradyunsg. It is weird that Python-Livereload is searching for `` in non-HTML files. That is definitely an upstream bug. The more curious thing to me is...

As you note, this is already possible via overriding template blocks. Personally, I would be happy to leave that as the only way. However, I can also see the usability...

> how long should backward compatibility go? That's hard to say. I expect we would evaluate that after we have the existing Google Analytics solution broken out into a plugin.

As MkDocs is a *Static Site Generator* I feel like handling server requests and returning responses is straying too far. Personally, if I was a potential new user looking for...

> > > but we take advantage of many of the great pymdown-extensions, > > > > > > I'm not sure how this matters. > > The point was...

At this time there is no public API. We consider MkDocs to be a command-line script only and not a library. Note that we are not yet to version 1.0...

I've assigned it to the Post-1.0 milestone. So we can leave it open and and we'll come back to it when we are ready. Thanks for your input.

Just a note that [tomchristie/mkautodoc][1] now exists and can be used to document the API. [1]: https://github.com/tomchristie/mkautodoc

During the file reorganization done in #2344, I noted that the theme documentation (now in `dev-guide-theme.md`) needs a refactor of its own. A lot has been added to that document...

> But ignoring certain files is a complexity that could be removed. I still can't honestly see why one would put any files in their `docs` folder unless they wanted...