weaveworks / wordepress

Tool support enabling hosting of technical documentation in WordPress
Apache License 2.0
7 stars 4 forks source link

Plugin rewrite rule installation is fragile #3

Open awh opened 8 years ago

awh commented 8 years ago

The rewrite rule installed by the plugin for hierarchical document URLs depends on the blog permalink settings being set to 'Post name' at the point of plugin activation. Furthermore, if you change the permalink settings back to 'Plain' the rule is lost entirely, requiring manual deactivation/activation of the plugin to restore it.

lukemarsden commented 8 years ago

This bit us today, maybe one day we can figure out how to de-fragilify the rewrite rules.

lukemarsden commented 8 years ago

also for posterity, the pinned messaged on #website on our slack is:

big fat warning - the wordepress plugin now installs a rewrite rule on activation; this does appear to be a little bit fragile in that some actions via the admin UI (see github.com/weaveworks/wordepress/issues/3) can cause the rewrite rule to vanish. If this happens, you can just deactivate & reactivate the wordepress plugin to get it back

rade commented 8 years ago

The big fat warning does not mention the symptoms one might see, namely all doc pages returning "not found".