Doc Site: Creating the documentation landing page integrated with Overture.bio

[gokul472]

This ticket is for the Documentation landing page.

• The documentation page will be created and integrated with the Overture.bio website.

• This page will have the dedicated sections for the search banner, DMS Installation instructions link, Help by topic links and product documentation callouts.

Note: the menu and footer changes are noted in this ticket: #46

ZEPLIN link https://zpl.io/bLMOvyD

[samrichca]

overture-stack/website#88

[samrichca]

WITH DOCS:

https://5f9acfe116493e00852858a6--overture.netlify.app/documentation

NO DOCS:

I need other tickets to be merged first (markdown POC)

[b-f-chan]

Testing will carryover to Sprint 9 (cc: @kcullion @rosibaj you may want to have a look also)

[kcullion]

thanks @b-f-chan I will have a closer look tomorrow, but it's looking great @samrichca

One thing I did notice, before I forget, is the active state is missing from the menu for the Documentation item

[samrichca]

@kcullion yup! it's in the nav highlight ticket

[kcullion]

yay! thanks @samrichca
can you tell I hate being lost haha

[samrichca]

wayfinding is important!!

[kcullion]

@b-f-chan @samrichca this looks great to me...just found a couple small things, and one is just a wording change.
(Sam, love your use of proper h1, h2, h3 tags!!)

[samrichca]

@kcullion i can't take the credit, that's fancy markdown processing for ya!

• docs header height will change when search is added
• updated chevron link... safari weirdness
• text update in oncojs card

https://5fa038750a252d00ee9247c6--overture.netlify.app/documentation

[kcullion]

Looks good @samrichca thanks. Even with the search is added - this area can be shorter. But you'll get to that with the search I'm sure :)

[b-f-chan]

Tested at latest netlify link:

• Following are correctly placed and present as in the Zeplin:
  • Header logo, links to Slack & GitHub
  • Nav menu items
  • Footer categories, copyright & links
  • DMS Intro section, Help by Topic section
  • Product Documentation section (all required products are listed with correct descriptions)
  • All links go to the correct page, except those where content not complete yet
  • Wording change in OncoJS section suggested by @kcullion above is fixed
  • Mobile behaviour is same as above, except one minor issue listed below
• Minor issues/nitpicks found, to confirm with @kcullion:
  • "@2020 Overture" - Should this be bold/heavier font weight? Looks that way in Zeplin - Confirmed not needed
  • In prod site, Netlify logo in footer is lined up with left margin of last column of links, but in this updated landing page it is not - Should it be? - Confirmed not needed
  • On mobile, Netlify logo overlaps Privacy, Terms & Conditions links - Fixed in Minor Fixes for Overture.bio Mobile Version #94

Not in scope:

• Search bar to be implemented in Docs Site: Integrate Algolia search #57
• Nav active state to be implemented in Doc Site: Highlight nav for Docs/Products pages #88
• Links to actual documentation content currently unavailable, will be created per product in separate tickets

[b-f-chan]

All issues addressed (see above comment). We are good to complete & close this ticket.