search

owncloud / docs-ui

Custom Antora UI theme for the official ownCloud documentation.
GNU Affero General Public License v3.0
8 stars 3 forks source link

Proposal: Homepage for documentation #48

Open LukasHirt opened 5 years ago

LukasHirt commented 5 years ago

@michaelstingl @settermjd @pmaier1

I would like to propose creation of a new homepage for documentation. Since in the current state I think users can have hard times navigating to different documentation than to the server one. Because of that I think is reasonable to have a place where it's clearly visible that we have docs divided into these products (or categories, I don't know how to call them exactly).

I worked last Friday and this one already on a potential design for this page. Here is what I came up with. Used icons in this design are only used as a placeholders - real icons that would be used in case this design would get green light I'd need to discuss with Andreas Wuensche. I'll include also multiple versions of navigation bar and footer.

Navigation bar

image

Footer

image

Complete page

image

michaelstingl commented 5 years ago

@LukasHirt Only the last navigation bar is valid. The name “ownCloud” must not be left out. (see https://owncloud.org/trademark/)

michaelstingl commented 5 years ago

@LukasHirt Please also check this proposal: https://github.com/owncloud/docs/issues/695

Maybe we can use the icons on a lower level…

michaelstingl commented 5 years ago

@LukasHirt I think idea was, to mimic the footer from https://owncloud.org/ . Maybe this is something that should be coordinated with the website people? /cc @hurradieweltgehtunter @lefherz

LukasHirt commented 5 years ago

@LukasHirt Only the last navigation bar is valid. The name “ownCloud” must not be left out. (see https://owncloud.org/trademark/)

Then we can also use either the first one or third option could be also adding the logo before the text "documentation"

image

image

Also there is one more problem related to the trademark - "The logo is white on dark blue (#1d2d44). It should not be used differently, especially not inverted." Which I did in the visual and two variants of footer. But honestly this seems a little bit weird rule. I don't mean changing colours to different ones but forbidding inverted version. Is there some reason why was this decided?

tboerger commented 5 years ago

I'm not sure if the index page and the different search bar placement is easily doable.

Beside this kind of index page I would prefer to get rid of the hidden component selection and show all components all the time similar to https://docs.mulesoft.com/general/ which is also built with antora based on a custom closed source theme.