exokitxr / webmr-docs

Exokit documentation
https://docs.webmr.io
4 stars 2 forks source link

Support WordPress landing page #97

Closed chrislatorres closed 5 years ago

chrislatorres commented 5 years ago

This PR is to give the WordPress landing page (https://webmr.io/) and the docs (https://docs.webmr.io/) a more cohesive/consistent experience. This includes:

chrislatorres commented 5 years ago

The redirect is taken from the Docusaurus docs: https://github.com/facebook/Docusaurus/blob/master/docs/getting-started-site-creation.md#docs-landing-page

ChristopherTrimboli commented 5 years ago

Removing Footer reduces socials conversions. Mobile load times are going to be increased 3-4x by introducing two diff domains with redirects. IMO keep the two sites separate, one is to display a high level view of Exokit, the other is for devs to find info for coding. SEO implications of those redirects have not been analyzed either. Other than a cheap attempt at cloning the navbar CSS and rehosting the readmes under a new domain, I do not see the value in doing this work. What problem is this solving? Is this a addition or a subtraction? Load times are longer, content is the same, CSS/style is worse. SEO is prob worse.

Wordpress site does its own job great for posting to Twitter and using it as a high level landing page. Docs site has BEEN putting in work for a long time, its optimized by Facebook too. I am hard pressed to believe there is anything wrong with it from a design standpoint.

The only PRs that would be worthwhile in Docs right now would be a content overhaul.

Attached is a quality comparison of navbar CSS.

BEFORE: bvcbxcvb

AFTER: xvzxcvz

chrislatorres commented 5 years ago

I agree it is best to keep the footer and keep the WP and doc sites as separate.

The redirect could cause issues so let's keep the docs.webmr.io landing page. I think we need to work on this to have more valuable information in the context of the docs, people should be able to find and get to where they need in the docs from the landing page.

For example I think the Decentraland docs landing page does a good job of this:

screenshot from 2018-10-14 10-56-04 https://docs.decentraland.org/

To keep the consistency of style between sites, I am going to modify the WP header style to be similar to the docs: screenshot from 2018-10-14 11-03-48 screenshot from 2018-10-14 11-03-33

What I think would still be useful:

I will make a separate PR for the above.