Non-categorized pages end up on on the site without styling

[irisli]

A user may go to a stellar-core page with the url https://www.stellar.org/developers/stellar-core/learn/admin.html. Out of curiosity, the user deletes the learn/admin.html and gets to https://www.stellar.org/developers/stellar-core/. However, that root stellar-core page looks like this:

Why?

This happens because all pages on the developer site is supposed to be under one of the four categories: Learn, Reference, Tools, and Beyond Code. It was decided a while back that some files did not need to be put on the developers site and thus were not categorized (not in a folder with the above name).

---

There are two solutions

Option 1: Exclude non-categorized files in build process

In the gulp process, instead of symlinking to the project docs page, we can symlink to these specific four folders.

Option 2: Include these files by categorizing them

This would involve moving the files from the docs folder root to their specific folders.

[irisli]

I think option 2 is the better way to go. I speculate some people would believe the developers site to be the source of all truth and not look at other docs in repos (sometimes I fall into this thinking too).

It is counterproductive to have our docs split up.

Another example of split up docs is the js-stellar-sdk project-root readme. This readme contains useful instructions but is nowhere to be found on the developers website.

[litnerdy]

Agree that option two would be preferable. Either way though, we do need to fix this, since a developer did find this page and wrote in about it.