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 ----