# HG changeset patch # User Marcin Lulek # Date 2016-08-26 10:25:01 # Node ID b24d0c2b6e490636fd6275672c9826ffc1c291e2 # Parent 771067bcc4eb386e5323a91e8504fc62d42b8957 docs: mention working with frontend using grunt and polymer diff --git a/docs/contributing/dev-setup.rst b/docs/contributing/dev-setup.rst --- a/docs/contributing/dev-setup.rst +++ b/docs/contributing/dev-setup.rst @@ -111,15 +111,18 @@ time operation:: Compile CSS and JavaScript ^^^^^^^^^^^^^^^^^^^^^^^^^^ -To use the application's frontend, you will need to compile the CSS and -JavaScript with Grunt. This is easily done from within the nix-shell using the -following command:: +To use the application's frontend and prepare it for production deployment, +you will need to compile the CSS and JavaScript with Grunt. +This is easily done from within the nix-shell using the following command:: + + grunt - make web-build +When developing new features you will need to recompile following any +changes made to the CSS or JavaScript files when developing the code:: -You will need to recompile following any changes made to the CSS or JavaScript -files. + grunt watch +This prepares the development (with comments/whitespace) versions of files. Start the Development Server ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/docs/contributing/standards.rst b/docs/contributing/standards.rst --- a/docs/contributing/standards.rst +++ b/docs/contributing/standards.rst @@ -45,6 +45,11 @@ JavaScript ---------- This currently remains undefined. Suggestions welcome! +However, we have decided to go forward with W3C standards and picked +WebComponents as the foundation of user interface. New functionality should +be implemented as components using the +`Polymer Project` `_ library +and should avoid external dependencies like `jquery`. HTML ----