<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Dec 4, 2013 at 2:33 PM, Maxim Dounin <span dir="ltr"><<a href="mailto:mdounin@mdounin.ru" target="_blank">mdounin@mdounin.ru</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Hello!<br>
<div class="im"><br>
On Wed, Dec 04, 2013 at 01:04:17PM -0800, David Birdsong wrote:<br>
<br>
> I noticed this a few months back. Why do the links on <a href="http://wiki.nginx.org" target="_blank">wiki.nginx.org</a> link<br>
> to<br>
> <a href="http://nginx.org/en/docs/" target="_blank">nginx.org/en/docs/</a> instead of to <a href="http://wiki.nginx.org" target="_blank">wiki.nginx.org</a>?<br>
><br>
> For example: the http core module doc link on<br>
</div>> <a href="http://wiki.nginx.org/Modulespoints" target="_blank">http://wiki.nginx.org/Modulespoints</a> -><br>
<div class="im">> <a href="http://nginx.org/en/docs/http/ngx_http_core_module.html" target="_blank">http://nginx.org/en/docs/http/ngx_http_core_module.html</a> instead of:<br>
> <a href="http://wiki.nginx.org/HttpCoreModule" target="_blank">http://wiki.nginx.org/HttpCoreModule</a><br>
><br>
> I kind of hate this. I find the wiki version of the module docs much more<br>
> readable.<br>
><br>
> Why the change?<br>
<br>
</div>Wiki pages for standard modules were created as an English<br>
translation of Russian docs long time ago, when there were no<br>
official English docs.  Since then, official English became<br>
available.<br>
<br>
In past years we've faced multiple cases of old/incorrect/missing<br>
descriptions on wiki confusing people, so these pages were<br>
deprecated and links were changed to official docs instead.<br>
Moreover, changing pages to do redirects instead was recenly<br>
discussed.  Supporing multiple versions of the documentation isn't<br>
something we want to spent time on, and bit rot on these pages on<br>
wiki can't be just ignored.<br>
<br>
What exactly do you find "much more readable"?  Wording?  Design?<br>
May be it's something that can be improved in the documentation?<br></blockquote><div><br></div><div>I won't claim to have any design chops, but as a reader, I prefer the wiki style and find that I can get information faster. I do a lot of nginx 'coding', so a large part of my life is spent referring to the docs--speed of navigation helps me a ton.</div>

<div><br></div><div>- the index layout is easier to scan, possibly because of the colors and right-justify?</div><div>- section headers seem absent on the standard docs<br></div><div><div>- the syntax highlighting on the wiki makes it easy to spot examples</div>

</div><div><br></div><div>I jump around to different modules frequently and so the icon-based navigation makes it easy for me to land my mouse on the modules or addons icon. I would have smudged the colors off of those icons with how frequently I'm press on them if these pages were physical.</div>

<div><br></div><div>For me it's just a simple case of one being superior to the other. If nobody else cares, I'll shut up and deal with it.</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">


<span class=""><font color="#888888"><br>
--<br>
Maxim Dounin<br>
<a href="http://nginx.org/en/donation.html" target="_blank">http://nginx.org/en/donation.html</a><br>
<br>
_______________________________________________<br>
nginx mailing list<br>
<a href="mailto:nginx@nginx.org">nginx@nginx.org</a><br>
<a href="http://mailman.nginx.org/mailman/listinfo/nginx" target="_blank">http://mailman.nginx.org/mailman/listinfo/nginx</a><br>
</font></span></blockquote></div><br></div></div>