atoum / atoum.github.io

Atoum website
http://atoum.github.io
2 stars 8 forks source link

Features page #5

Open jubianchi opened 8 years ago

jubianchi commented 8 years ago

I think the "Features" page contains too much things. We should split it in several pages:

The tree would look like:

+ Features
|-- Flexible structure
|-- Execution engines
|-- Vocabulary
|-- Meaningful asserters
|-- Mocks
|-- Virtual file system
|-- Reports
|-- Loop and autorun modes
|-- Configuration file in PHP
|-- Third-party integration
|-- Fast
|-+ Extensions
  |-- ruler-extension
  |-- json-schema-extension
  |-- ...

Doing so will allow us to write more detailed contents and it could perhaps become something like Cookbooks to help users take advantage of those features.

Moreover, I think we should rename the "Vocabulary" and "Fast" sections but honestly I don't know how to name them.

mikaelrandy commented 8 years ago

:+1:

Hywan commented 8 years ago

:-1: Users will have to click twice. This is wrong. If the page is too long, we have to reduce section's size and add links to a detail page. Thoughts?

Hywan commented 8 years ago

Or, instead of a list, we must have a grid with self-describing icons. We are not designers, don't forget that :-/.

jubianchi commented 8 years ago

reduce section's size and add links to a detail page

This is what I meant: less text ont the "Features" page and link to detailed pages. In its current state, I doubt users will ever read the whole page.

Hywan commented 8 years ago

Less text, agree. Just a simple list, not agree :-).

Grummfy commented 7 years ago

So about this, we all agree that we need to change in a direction or another.

Today we got this structure :

What I will do is this

Sub pages: