# Why the change in links on the wiki?

**URL:** <https://www.ruby-forum.com/t/why-the-change-in-links-on-the-wiki/237886>\
**Category:** NGINX\
**Created:** [December 4, 2013, 10:05pm UTC](https://www.ruby-forum.com/t/why-the-change-in-links-on-the-wiki/237886 "2013-12-04T22:05:07Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![musicdenotation](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/ea666f/32.png) [@musicdenotation](https://www.ruby-forum.com/u/musicdenotation)\
**Post date:** [December 4, 2013, 10:05pm UTC](https://www.ruby-forum.com/t/why-the-change-in-links-on-the-wiki/237886/1 "2013-12-04T22:05:07Z")

</div>

I noticed this a few months back. Why do the links on [wiki.nginx.org](http://wiki.nginx.org)  
link  
to  
[nginx documentation](http://nginx.org/en/docs/) instead of to [wiki.nginx.org](http://wiki.nginx.org)?

For example: the http core module doc link on  
[http://wiki.nginx.org/Modulespoints](http://wiki.nginx.org/Modulespoints) →   
[Module ngx\_http\_core\_module](http://nginx.org/en/docs/http/ngx_http_core_module.html) instead of:  
[http://wiki.nginx.org/HttpCoreModule](http://wiki.nginx.org/HttpCoreModule)

I kind of hate this. I find the wiki version of the module docs much  
more  
readable.

Why the change?

---

<div class="post-metadata">

**Author:** ![David\_Birdsong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/d/bb73d2/32.png) [@David\_Birdsong](https://www.ruby-forum.com/u/David_Birdsong)\
**Post date:** [December 4, 2013, 11:33pm UTC](https://www.ruby-forum.com/t/why-the-change-in-links-on-the-wiki/237886/2 "2013-12-04T23:33:55Z")

</div>

Hello!

On Wed, Dec 04, 2013 at 01:04:17PM -0800, David Birdsong wrote:

> readable.
> 
> Why the change?

Wiki pages for standard modules were created as an English  
translation of Russian docs long time ago, when there were no  
official English docs. Since then, official English became  
available.

In past years we’ve faced multiple cases of old/incorrect/missing  
descriptions on wiki confusing people, so these pages were  
deprecated and links were changed to official docs instead.  
Moreover, changing pages to do redirects instead was recenly  
discussed. Supporing multiple versions of the documentation isn’t  
something we want to spent time on, and bit rot on these pages on  
wiki can’t be just ignored.

What exactly do you find “much more readable”? Wording? Design?  
May be it’s something that can be improved in the documentation?

–  
Maxim D.  
[http://nginx.org/en/donation.html](http://nginx.org/en/donation.html)

---

<div class="post-metadata">

**Author:** ![David\_Birdsong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/d/bb73d2/32.png) [@David\_Birdsong](https://www.ruby-forum.com/u/David_Birdsong)\
**Post date:** [December 4, 2013, 11:59pm UTC](https://www.ruby-forum.com/t/why-the-change-in-links-on-the-wiki/237886/3 "2013-12-04T23:59:38Z")

</div>

On Wed, Dec 4, 2013 at 2:33 PM, Maxim D. [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> > [Module ngx\_http\_core\_module](http://nginx.org/en/docs/http/ngx_http_core_module.html) instead of:  
> > available.  
> > May be it’s something that can be improved in the documentation?

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.

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

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.

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 class="post-metadata">

**Author:** ![David\_Birdsong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/d/bb73d2/32.png) [@David\_Birdsong](https://www.ruby-forum.com/u/David_Birdsong)\
**Post date:** [December 5, 2013, 7:48am UTC](https://www.ruby-forum.com/t/why-the-change-in-links-on-the-wiki/237886/4 "2013-12-05T07:48:12Z")

</div>

— Original message —  
From: “Maxim D.” [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid)  
Date: 5 December 2013, 00:33:44

> > [Module ngx\_http\_core\_module](http://nginx.org/en/docs/http/ngx_http_core_module.html) instead of:  
> > available.  
> > May be it’s something that can be improved in the documentation?  
> > From my point of view, there is one thing which would be very useful in  
> > the new official docs ([nginx.org/\*/docs](http://nginx.org/*/docs)): this is content of directives  
> > of current module. May be even with ‘fixed’ position.
