Comments (3)
Hi @nettofarah, thanks for creating this issue!
Documentation should definitely be on our Roadmap, and is currently not, see ROADMAP.md. I will try to write my thoughts here, that might inspire what will be in the Roadmap:
Storybook with examples
The first part is to have a Storybook live, which is what you are describing. This will contain simply the component use cases needed for developing, and is lacking as a form of documentation. It won't have code blocks containing usage examples, or property documentation.
This should be fairly straightforward to implement if the packages are actually published (they are no yet at the moment). If that is the case, we can build a static storybook and push that to the gh-pages
branch. This might require something like Circle for CI, which I am not very familiar with.
Low scope docs in Storybook
The second part is to create the components that are required to build out documentation. A highlighted CodeBlock
component, and maybe some useful helper components / utilities in a evergreen-docs
package. I am thinking evergreen-docs
will contain some Readme Markdown rendered of some sort.
Dedicated documentation website
The third part is to create documentation website, similar to how AtlasKit approaches this. This will require a bigger set of components and resources to be available.
Design documentation (long term goal)
The last part is to create design documentation. That will be primarily for designers, and is more focused around what is the right way to use a component or patter, instead of showing you how to implement it.
from evergreen.
Closing this since the Storybook is now available https://segmentio.github.io/evergreen/
from evergreen.
@jeroenransijn storybook is working great for the demo, but it would be nice to see the components with their props alongside and be able to play with them right there! I'd be happy to give it a shot.
Did you have any plans for this?
from evergreen.
Related Issues (20)
- Textarea component loses borders under certain conditions
- Property 'children' does not exist on type 'IntrinsicAttributes & TooltipProps'. HOT 4
- SSR with Remix HOT 3
- `SideSheet` prevents page scroll even after closing, when `preventBodyScrolling` set to true HOT 3
- Style of selected tab differs between tab link and basic tab HOT 3
- Property `selected` should include `PropTypes.number` to allow integer values HOT 1
- Can't use (intent) and (type) property at the same time in <Button> component HOT 1
- Badge color should not have 'automatic' in its typing
- Feature request: Tooltip pointer arrow triangle shape (optional) HOT 1
- LinkProps.target should be `HTMLAttributeAnchorTarget | undefined`
- Button disabled icon color doesn't change HOT 2
- Badge no longer shows text if you pass color hex code HOT 8
- CSS modification HOT 1
- Ability to handle overlay/close clicks in Dialog component, onBeforeClose HOT 2
- inputValue.trim is not a function when using object array for items in autocomplete with "allowOtherValues"
- NextJs 13 App Router
- zIndex for Toaster HOT 1
- Toaster CSS Overide
- Project still maintained? HOT 13
- Footer Component Positioning Problem HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from evergreen.