source - front-end documentation engine

SourceFront-end documentation engine

Robert Haritonov

Pain

Pain

Pain

Developers pain

• Duplicated code

• Infinite redesign

• Front-end testing and documentation

05

Less chaos

More fun

Collaboration problems

• Supporting common codebase

• Communication with designers, testers back-end devs

• External teams - Freelancers

08

Solution?

Source

Source solves problems with

• Documentation

• Frontend development

• Interface testing

• Collaboration - one language for all team

12

Open Source!

Source!sourcejs.com

Rethinkingdocumentation

Frontend development process

Yesterday

IDE ➧ Static.html ➧ Documentation? ➧ Deployment

16

Frontend development process

Tomorrow

IDE ➧ Source ➧ Deployment

17

Live demo time

• Documentation is created from enhanced static files

• Showing how documentations looks in real live

• Comparing documentation and real-life interfaces

Please check presentation video recording for more details

18

Web app fordocumentation

Core modulesand plugins

Live demo time

• Showing engine plugins, native and custom

• View source

• Navigation and search

• Comments

• Spec status

Please check presentation video recording for more details

26

Source!sourcejs.com

Technologies

• JavaScript

• RequireJS, Jasmine

• NodeJS, Grunt, PhantomJS, Volo

• and more to come

32

Future

• Auto-testing with PhantomJS

• Auto documentation generation

• Interface for fast experiments with CSS

• Interface for building prototypes from existing blocks

33

Thank you!

Robert HaritonovSourcejs.com @operatino_en r@rhr.me

Presentation slides rhr.me/pres/source-min

Source!sourcejs.com