hadoop-common-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andrew Wang (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HADOOP-14163) Refactor existing hadoop site to use more usable static website generator
Date Tue, 14 Mar 2017 23:03:41 GMT

    [ https://issues.apache.org/jira/browse/HADOOP-14163?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15925212#comment-15925212

Andrew Wang commented on HADOOP-14163:

This looks great! I think this is something we can commit then iterate on, thanks for doing
the initial work [~elek]!

A few quick points:

* In the top navbar, the "Apache Hadoop" is already a link, do we need the "Home" link too?
Remove "Home" if not?
* Recommend moving the bylaws and committer criteria under "Community", since they're Hadoop
specific (not ASF).
* I think we can remove the ASF navbar links entirely, and have a link to the main ASF site
in the site footer, and somewhere on the landing page.
* Is it possible to display the latest few news stories right on the homepage? If so, IMO
we make it full-width and get rid of "Modules" and move "Related projects" to a separate page
(under "Community"?). "Modules" seems like filler content and too dev-oriented, we should
explain how HDFS/YARN/MR interact in a more user-oriented way.
* For viewing older news stories, is it possible to paginate so you can view e.g. 10 per page?
Having to click each one to view is a bit unfriendly.
* I looked at http://hadoop.anzix.net/release/2.7.2.html and the Documentation link is broken
(and seems to point to 3.0.0-alpha2).
* We also lost some links from the old website, like "Who uses Hadoop?" "Sponsorship" etc.

Things to all of us to think about for the future:
* We really should improve our "Learn more" and "Getting started" content, it's not that user
friendly and also jarring now that it links to the release tarball docs with the old style.
* It'd be good to have some more introductory content (with figures) on the main page.

> Refactor existing hadoop site to use more usable static website generator
> -------------------------------------------------------------------------
>                 Key: HADOOP-14163
>                 URL: https://issues.apache.org/jira/browse/HADOOP-14163
>             Project: Hadoop Common
>          Issue Type: Improvement
>          Components: site
>            Reporter: Elek, Marton
>            Assignee: Elek, Marton
>         Attachments: hadoop-site.tar.gz, hadop-site-rendered.tar.gz
> From the dev mailing list:
> "Publishing can be attacked via a mix of scripting and revamping the darned website.
Forrest is pretty bad compared to the newer static site generators out there (e.g. need to
write XML instead of markdown, it's hard to review a staging site because of all the absolute
links, hard to customize, did I mention XML?), and the look and feel of the site is from the
00s. We don't actually have that much site content, so it should be possible to migrate to
a new system."
> This issue is find a solution to migrate the old site to a new modern static site generator
using a more contemprary theme.
> Goals: 
>  * existing links should work (or at least redirected)
>  * It should be easy to add more content required by a release automatically (most probably
with creating separated markdown files)

This message was sent by Atlassian JIRA

To unsubscribe, e-mail: common-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-issues-help@hadoop.apache.org

View raw message