1507037 - Consolidating redundant/isolated documentation

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: General, enhancement)

Description

[kmsandst]

What feature should be changed? Please provide the URL of the feature if possible.
==================================================================================
Consolidating pages on the Wiki/reducing amount of isolated pages.

For instance, as far as I could tell, this page does not appear to be linked in the WebGL section of the site, but rather only in the Learn section:

https://developer.mozilla.org/en-US/docs/Learn/WebGL/By_example

What problems would this solve?
===============================
Reducing the amount of redundant/isolated information would ensure that editors are not adding information that already exists, and would allow them to focus on editing existing content.

It would also ensure that visitors like me can find all of the relevant information about a topic in one spot without hunting for it in different parts of the site.

Who would use this?
===================
Ideally every user on the site.

What would users see?
=====================
Users would see information in one spot where they would expect, and not fragmented in several places.

What would users do? What would happen as a result?
===================================================
Users would be able to get to all of the information they need quicker without having to search through the rest of the documentation to find it.

Is there anything else we should know?
======================================
I love this website, it's very helpful for me as a web developer. However, sometimes it's hard to know if I've already visited a page before because of the amount of redundant links.

Comment 1

[Chris Mills [:cmills]]

In the particular case of the WebGL "by example" pages, I have fixed this. I have deleted the main WebGL page from the learning area (see https://developer.mozilla.org/en-US/docs/Learn/WebGL for more context)

I have moved the "by example" pages to the main WebGL area: https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/By_example

It's got an entry on the front page: https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API

And I've updated the sidebars to move them from the learning area sidebar to the WebGl sidebar: https://github.com/mdn/kumascript/pull/999

For other IA-related matters, please feel free to post more bugs. Thanks for reporting!