@jinntec/fore 1.0.0-3 → 1.0.0

package/README.md

@@ -6,28 +6,25 @@
 ![GitHub top language](https://img.shields.io/github/languages/top/jinntec/fore)
 
 
-
-
-![logo](resources/images/light-200.png)
+<img src="resources/images/light7.png" width="400">
 
 >'situated in front of something else' - Merriam Webster
 
 [![Twitter URL](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Ftwitter.com%2FJinnForeTec)](https://twitter.com/JinnForeTec) 
 
-## [Demos Demos Demos Demos Demos](https://jinntec.github.io/Fore)
-
-Sorry for being loud - some people complaining not finding demos.
-
-## [Element Reference](https://jinntec.github.io/Fore/doc/reference.html)
+[Homepage](https://jinntec.github.io/Fore/) | 
+[Documentation](https://jinntec.github.io/fore-docs/) |
 
-For latest and greatest please use a local installation. See 'Running demos and docs'
 
-# What it does
+# Declarative user interfaces in plain HTML
 
 Fore lets you write data-driven front-end applications in a declarative way
-just using HTML5 and JavaScript (ES6). 
+just using HTML5 Web Components. 
 
 ![todo](resources/images/todo-screen.png)
+
+[Source code](https://github.com/Jinntec/Fore/blob/960e093fadfbc96eb8514721fb7b53462567f1ec/demo/todo2.html) for above example just uses 53 lines of HTML.
+
 The use cases range from simple to complex forms to full single page
 applications. It can be used standalone or in conjunction with other web 
 components or frameworks. 
@@ -36,6 +33,21 @@ By using the bare metal of the browser
 platform, Fore integrates well with any other library you might want to use in
 conjunction with it.
 
+## Features
+
+* implemented as vanilla web components in ES6
+* fully descriptive - just HTML5
+* MVC architecture 
+* state engine with dependency tracking for optimized updating
+* lifecycle with detailed state events
+* descriptive actions for data mutations (setvalue, insert, delete)
+* multiple XML (or JSON) data instances
+* group, repeat, dialog + switch container components
+* generic UI control to bind any kind of control 
+* bound template expressions
+* powerful XPath/XQuery 3.1 support in the browser
+* Submission module declaratively wrapping the fetch API
+
 
 ## An xformish framework in Web Components
 
@@ -45,8 +57,7 @@ Standard but applies those to the world of HTML5 Web Components.
 Going beyond just forms it nicely integrates with Web Components, allowing to configure, 
 ochestrate and interact with them by binding their properties to data instances.
 
-Fore uses XML as it's main data model but allows to use JSON alternatively or at the same time. Accessing and mutating JSON data with declarative
-actions makes JSON processing even easier than in native JavaScript.
+Fore uses XML as it's main data model but allows to use JSON alternatively or at the same time. 
 
 Through the wonderful [fontoXPath library](https://github.com/FontoXML/fontoxpath) Fore is able to process XML in the client with XPath 3.1 and 
 XQuery 3.1 support.
@@ -55,19 +66,6 @@ Being as close as possible to the web platform standards available in browsers n
 JS framework or component library.
 
 
-## Features
-
-* MVC architecture 
-* state engine with dependency tracking
-* fully descriptive
-* lifecycle with detailed state events
-* multiple XML (or JSON) data instances
-* group, repeat + switch container components
-* generic UI control to bind any kind of component 
-* bound template expressions
-* powerful XPath/XQuery 3.1 support in the browser
-* Submission module declaratively wrapping the fetch API
-
 ## Framework-agnostic
 
 Fore focuses on providing a stable processing engine for model-driven
@@ -103,13 +101,6 @@ customize the wiring of the widget you use.
 
 More examples are found in the demos (see running)
 
-## Documentation
-
-Currently the demos are the documentation (see 'demo' folder). All files listed on the demo.html page are expected to work
-and serve the purpose of documentation. The intend is to have at least one demo
-for each feature and show how to use it with an example.
-
-Some of them also offer some explanations and should give you an idea of building your own.
 
 ## Development and Contributions
 
@@ -145,7 +136,7 @@ Include the following snippet at end of body:
 
 Run
 
-```npm install @jintec/fore```
+```npm install @jinntec/fore```
 
 in your project to install it.