SymbiFlow / symbiflow-website

SymbiFlow Website Source
https://f4pga.org
ISC License
10 stars 9 forks source link

Update the website #41

Closed rw1nkler closed 4 years ago

rw1nkler commented 4 years ago

This commit updates the current SymbiFlow website. It provides the following changes:

The new changes were inspired by the issues available in this repository. This PR resolves:

mithro commented 4 years ago

Can you upload the preview for me to review?

rw1nkler commented 4 years ago

All the generated files are available in the symbiflow-scratch bucket that you created for me @mithro

mithro commented 4 years ago

Please put a link here in this pull request.

rw1nkler commented 4 years ago
Google Cloud Platform
Google Cloud Platform lets you build, deploy, and scale applications, websites, and services on the same infrastructure as Google.
mithro commented 4 years ago

The For Developers header is a bit confusing;

mithro commented 4 years ago

Rework the following paragraph to be positive only;

SymbiFlow aims to optimise and automate FPGA development workflows and to push FPGAs towards more widespread adoption, bypassing the uninviting, closed, vendor-specific ecosystem.

mithro commented 4 years ago

Each of the cells in the table should be links.

mithro commented 4 years ago

Current status table should have links.

mithro commented 4 years ago

The tutorial's section seems a bit weird as a bunch of the links are not tutorials.

mithro commented 4 years ago

I think we want a Contact / Get Help link at the top with the Getting Started / Developers links?

mithro commented 4 years ago

This is already a pretty big improvement on the current website, so if things are not an easy fix we can convert my suggestions to GitHub issues and then merge this pull request and follow up with more pull requests.

I think the order of the contents in the new website isn't quite right.

I would like to see the order to be something like;

  1. call to action text
  2. news / updates / what has changed recently
  3. pretty pictures / diagrams / etc
  4. More detailed background information

Sections 1 and 2 should appear "above the fold" at normal computer resolutions.

I think there should be two call to actions in the first section (feel free to rework the exact words - these are just the "jists" that I would be after);

I wonder if there should be a rotating picture of potential development boards / screenshots above (or maybe even behind) the "getting started" call to action?

mgielda commented 4 years ago

Yes, I would be all for including the remarks that are simple to fix and merging this one, and then treating the other topics separately, as some of those are a little philosophical and might need some discussion etc.

When you say the features should be links, can you suggest where we should be linking to? I have some ideas but not for all the icons. But generally speaking it's a nice idea.

mgielda commented 4 years ago

Sorry, missed Tim's suggestion for the other section. Then we should have "Get started" and "Help contribute" for consistency. Alternative suggestion (from me) - "Getting started" and "Contributing to SymbiFlow". @mithro ?

mithro commented 4 years ago

Get Started! and Help Contribute seem pretty good?

Maybe Start using! and Help Contribute?

mithro commented 4 years ago

Or Start using!, Getting help and Contribute now!?

rw1nkler commented 4 years ago

I have changed:

I've also switched the detailed description with the talks section. The rest of the changes will be provided in next PRs. Can we merge it now? @mithro

The current preview is available in the bucket: https://storage.googleapis.com/symbiflow-scratch/index.html

mithro commented 4 years ago

@rw1nkler We can merge as soon as you have responded to each of the comments with a link to the new github issue tracking what hasn't been finished in this pull request.

mithro commented 4 years ago

@rw1nkler BTW You can create directories and stuff in the symbiflow-scratch bucket. I suggest using something like gs://symbiflow-scratch/rw1nkler/symbiflow-website/<git describe output> so you can upload multiple versions for to compare. I can't actually remember what the first version looked like when compared to your new version so I can't check you have actually made the changes I was thinking you should :-P

rw1nkler commented 4 years ago

1.

The For Developers header is a bit confusing;

* Is it for developers who want to develop the symbiflow tools?

* Is it for developers who want to use symbiflow?

The section has been renamed to Contribute now

2.

Rework the following paragraph to be positive only;

SymbiFlow aims to optimise and automate FPGA development workflows and to push FPGAs towards more widespread adoption, bypassing the uninviting, closed, vendor-specific ecosystem.

Done

3.

Each of the cells in the table should be links.

* Free & Open Source

* Multi-platform

* Vendor-neutral

* Interchangeable tool suite

* Growing community

* Look inside and improve

I've created a dedicated issue for this (https://github.com/SymbiFlow/symbiflow-website/issues/42)

4.

Current status table should have links.

Done

5.

The tutorial's section seems a bit weird as a bunch of the links are not tutorials.

The section has been renamed to Resources

6.

Contact / Get Help link at the top with the Getting Started / Developers links?

I've created a dedicated issue for this (https://github.com/SymbiFlow/symbiflow-website/issues/44)

7.

This is already a pretty big improvement on the current website, so if things are not an easy fix we can convert my suggestions to GitHub issues and then merge this pull request and follow up with more pull requests.

I think the order of the contents in the new website isn't quite right.

I would like to see the order to be something like;

1. call to action text

2. news / updates / what has changed recently

3. pretty pictures / diagrams / etc

4. More detailed background information

Sections 1 and 2 should appear "above the fold" at normal computer resolutions.

I think there should be two call to actions in the first section (feel free to rework the exact words - these are just the "jists" that I would be after);

* "Getting started" -- A call to action around getting started as a user of the toolchain.

* "Help contribute" -- A call to action around helping the symbiflow project.

I wonder if there should be a rotating picture of potential development boards / screenshots above (or maybe even behind) the "getting started" call to action?

I've created a dedicated issue for this (https://github.com/SymbiFlow/symbiflow-website/issues/43)

rw1nkler commented 4 years ago

@mithro, I've uploaded the website files to the bucket

Previous version:

Current version:

mithro commented 4 years ago

@rw1nkler - Can you make those links?

rw1nkler commented 4 years ago
mithro commented 4 years ago

Okay, I'm going to merge this now and we can work on further improvements shortly.