Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs] Add a VISION.md file #6982

Merged
merged 5 commits into from Jun 1, 2017
Merged

[docs] Add a VISION.md file #6982

merged 5 commits into from Jun 1, 2017

Conversation

oliviertassinari
Copy link
Member

@oliviertassinari oliviertassinari commented May 28, 2017

The WHY and WHAT of this project.

  • PR has tests / docs demo, and is linted.
  • Commit and PR titles begin with [ComponentName], and are in imperative form: "[Component] Fix leaky abstraction".
  • Description explains the issue / use-case resolved, and auto-closes the related issue(s) (http://tr.im/vFqem).

@oliviertassinari oliviertassinari added docs Improvements or additions to the documentation next labels May 28, 2017
VISION.md Outdated
We also focus on providing all the low-level tools needed to build a rich user-interface with React.
Once you solve the Material design specification (that put the bar very high),
you should be able to take advantage of it for you own business custom style.
We want to see companies succeeding making Material UI matches their brand. We don't want them to feel that their UI looks like anther Google product.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

anther -> another

Copy link
Member

@mbrookes mbrookes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@oliviertassinari I've focused on the content rather than grammar at this stage.

VISION.md Outdated
We want Material-UI to become whatever is generally useful for application development in the spirit of the Material Design spec.
This means Material Design with a general use UI library of components that are needed by many. This general use doesn't imply any other design methodology.
It also means we will have components or combinations that are simply not addressed in the spec.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not totally clear on what this paragraph is alluding to. What does general-use mean in this context, and what is the "more" mentioned in the previous paragraph?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated to address flow of intent.

VISION.md Outdated
This means Material Design with a general use UI library of components that are needed by many. This general use doesn't imply any other design methodology.
It also means we will have components or combinations that are simply not addressed in the spec.

We also focus on providing all the low-level tools needed to build a rich user-interface with React.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We do?

VISION.md Outdated
Once you solve the Material design specification (that put the bar very high),
you should be able to take advantage of it for you own business custom style.
We want to see companies succeeding making Material UI matches their brand. We don't want them to feel that their UI looks like another Google product.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"We don't want them to feel that their UI looks like another Google product."

Pretty sure that's Google's intent behind Material Design! 😆

Copy link
Member

@rosskevin rosskevin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've just added a rewrite of the original concepts, I'm good with this version. I welcome other critiques.

@oliviertassinari
Copy link
Member Author

@rosskevin All good with that version ❤️

VISION.md Outdated
From a user point of view, we want Material-UI
- to deliver on fully encapsulated/composable react components
- to be themable/customizable
- to promote developer joy
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@oliviertassinari I think it's great!

Here are some other bullets that I'd like to suggest.

  • to be cross browser compatible and accessible

  • to promote developer joy, a sense of community, and an environment where new and experienced developers can learn from each other

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hai-cea Thanks for the feedback. Feel free to edit the PR, you have the edit button to do so 😄 .

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @oliviertassinari :)

@oliviertassinari
Copy link
Member Author

Is anyone needed more time to review it? Otherwise I will merge it.

@oliviertassinari oliviertassinari merged commit 4e1639c into mui:next Jun 1, 2017
@oliviertassinari oliviertassinari deleted the next-vision branch June 1, 2017 08:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to the documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants