Proposal home with Paradox

[samueleresca]

The following PR is related to the following disscussions:

• simple paradox-based homepage setup #4
• https://lists.apache.org/thread/fthn305vphk7l61gsldm2jyon7q7tz4w

Few notes:

• The styling is specific for the homepage. Everything else in the docs remains untouched.
• The actual content is mostly unchanged.
• In order to add a dedicated style to the page, I need to override the the home.st to include the styling. Solved by: Adding a dedicated stylesheet to the page layout pekko-sbt-paradox#85

I attach the visual results of the changes:

[pjfanning]

copying this non ASF, non Apache licensed code to here means we need to change the LICENSE and NOTICE for this repo.

[samueleresca]

copying this non ASF, non Apache licensed code to here means we need to change the LICENSE and NOTICE for this repo.

I might have found a better approach to this, see: apache/pekko-sbt-paradox#85. The change would allow to have a stylesheet dedicated to the page on top of the common theme stylesheet.

If this approach is successful we don't need to override home.st at all

[pjfanning]

lgtm

[laglangyue]

LGTM，good works.
For better:
could you test with google translator, no need for very strict testing,
because some developers are not native English speakers.

[samueleresca]

I standby on merging this I want to proceed first with: apache/pekko-sbt-paradox#84 (less moving piecies)

[samueleresca]

LGTM，good works. For better: could you test with google translator, no need for very strict testing, because some developers are not native English speakers.

Good point, I will do a bit of testing on other langs before merging

[samueleresca]

@pjfanning I'm proceeding today by resolving conflicts with #54 and re-test the changes. I'm might send over the PR for another approval

[samueleresca]

LGTM，good works. For better: could you test with google translator, no need for very strict testing, because some developers are not native English speakers.

@laglangyue I verified the page with google transltor localized in multiple lang. The spacing and the menu respond correctly. If you have any specific lang you want to test please let me know.

[pjfanning]

samples and modules seem now to appear to in the index page

There are probably links to the old samples and modules pages so we should probably go to our other docs to check for links and repoint them to the index page. We should be planning in near future to remove the samples and modules pages. We could add .htaccess redirects to redirect those links to the index page.

[samueleresca]

I think it makes sense to keep samples.md and modules.md as dedicated pages. I just noticed that using ## Modules in the index.md plays funny with the navigation menu of the other pages.

I have updated index.md to declare the 2 subtitles "Sample" and "Modules" that do not interfere with the structure of the other pages.

[pjfanning]

lgtm

[samueleresca]

Proceeding with the rebase in asf-staging and asf-site in the afternoon