From e558318dd2e4f7a5c13d91209cdf4a0051e9a670 Mon Sep 17 00:00:00 2001 From: Dirkjan Ochtman Date: Wed, 8 Mar 2017 20:33:55 +0100 Subject: Improve feature documentation in README and docs --- README.md | 18 ++++++++++++++---- askama/src/lib.rs | 8 ++++---- 2 files changed, 18 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index f842d2c..24c4a13 100644 --- a/README.md +++ b/README.md @@ -12,16 +12,26 @@ See below for an example, or read [the documentation][docs]. **"Pretty exciting. I would love to use this already."** -- [Armin Ronacher][mitsuhiko], creator of Jinja -Currently implemented features: +### Feature highlights + +* Construct templates using a familiar, easy-to-use syntax +* Benefit from the safety provided by Rust's type system +* Template code is compiled into your crate for optimal performance +* Templates only convert your data as needed +* Templates can access your Rust types directly, according to Rust's + privacy rules +* Debugging features to assist you in template development +* Templates must be valid UTF-8 and produce UTF-8 when rendered +* Works on stable Rust + +### Supported in templates -* Generates fully type-safe Rust code from your templates * Template inheritance * Basic loops and if/else if/else statements * Whitespace suppressing with '-' markers * Some built-in filters -* Works on stable Rust -Askama is in heavy development, so it currently has some limitations: +It's still early for Askama, so there are some limitations: * Only a small number of built-in template filters have been implemented * User-defined template filters are not supported yet diff --git a/askama/src/lib.rs b/askama/src/lib.rs index 94c2f7f..311992f 100644 --- a/askama/src/lib.rs +++ b/askama/src/lib.rs @@ -20,14 +20,14 @@ //! # Feature highlights //! //! * Construct templates using a familiar, easy-to-use syntax -//! * Fully benefit from the safety provided by Rust's type system -//! * Templates do not perform eager conversion to strings or other types +//! * Benefit from the safety provided by Rust's type system //! * Template code is compiled into your crate for optimal performance -//! * Templates can directly access your Rust types, according to Rust's +//! * Templates only convert your data as needed +//! * Templates can access your Rust types directly, according to Rust's //! privacy rules //! * Debugging features to assist you in template development -//! * Included filter functions will provide easy access to common functions //! * Templates must be valid UTF-8 and produce UTF-8 when rendered +//! * Works on stable Rust //! //! # Creating Askama templates //! -- cgit