Documentation landing page update

[david-rhodes]

• Polish, organization, and more information.

[david-rhodes]

I feel we should add more information about what the SDK is and what you can build with it.

[isiyu]

Is the goal to keep the documentation home page and the index landing page always in sync? It seems redundant and possibly confusing to have the landing page be the front page of the "documentation" section. I see options:
1 - have https://www.mapbox.com/mapbox-unity-sdk/ start on the 'Documentation` homepage; so we won't need
2 - have a more broad index.html that just says "welcome to mapbox unity sdk"

I feel we should add more information about what the SDK is and what you can build with it.

I think step by step narrative guides on how to recreate each of the examples would go a long way here. Or were you thinking links to blog posts?

[david-rhodes]

In my mind, the index should be quite polished and informative. I think we can strip out the redundant getting started link. I kept it in for now because I think we linked some people there already and didn't want to send them to a broken link. Maybe we can deprecate next publish?

For extra information in the index, I was thinking of more general stuff--key features, potential use-cases, etc.

[david-rhodes]

@BergWerkGIS is there any way we can get the table of contents to show for the index page?

[isiyu]

• did a pass at the landing page, borrowed heavily from DocFX's landing page
• updated Mapbox logo/favicon
• added a blog widget, not sure how helpful that is

@david-rhodes this may be a different direction from what you had in mind.
In writing this comment, i looked at the Unity docs and see what you're saying. I think in the long run once we have a more robust Manual section with tutorials, we should just have the landing page be the Manual/Tutorial and guides section. @BergWerkGIS is it possible to have the index.html land on the written docs home page

This is what the landing page should look like:

[isiyu]

replaced the blogs widget with the original getting landing page info.

[wilhelmberg]

@BergWerkGIS is it possible to have the index.html land on the written docs home page

@isiyu you mean get the contents of 00-getting-started.md to display directly at https://www.mapbox.com/mapbox-unity-sdk/ ?

Haven't tested, but I think this would be the place to reference it:

mapbox-unity-sdk/documentation/docfx_project/docfx.json

Line 66 in bc74732

{ //put docs/index.md into _site root as start page

[david-rhodes]

replaced the blogs widget with the original getting landing page info.

Did you push? I don't see this when building locally.

[isiyu]

@david-rhodes sorry! just pushed!