Further modules included.
[yaffs-website] / web / modules / contrib / better_formats / README.txt
diff --git a/web/modules/contrib/better_formats/README.txt b/web/modules/contrib/better_formats/README.txt
new file mode 100644 (file)
index 0000000..3bd2bb9
--- /dev/null
@@ -0,0 +1,32 @@
+This very basic documentation for during development.
+Better docs will be generated closer to a full release.
+
+
+The only items currently implemented in the D8 version of Better Formats are:
+
+1. Display options: When BF is enabled you will have permissions at
+   admin/people/permissions to control per role display of:
+   1. format tips
+   2. format tips link
+   3. format selection for [entity]
+
+   #3 is actually several permissions. There is one for each entity in your site.
+
+2. Simple field level default format.
+   This allows you set a field level default format using the standard "Default Value"
+   setting of a field. This is only possibly normally if you enter something in the
+   text field for the field api to save the format too. BF gives you the ability
+   to set the format WITHOUT having to set a value in the field.
+
+   1. At admin/config/content/formats/settings enable "Use field default" option.
+   2. Create a field on one of your entities with one of the following types: Text, Long Text, Long text with summary.
+   3. Save the field.
+   4. Now go back and edit the field you just saved. This is required because of
+      how the field default value option works.
+   5. You will now see a "Text format" dropdown below your field in the
+      "Default Value" area. Set the default format in the dropdown.
+   6. Save the field. Default will now be used on all new content forms for that field.
+
+3. Allowed format selection for each text field.
+
+4. Ordering of formats in Formats select box for each text field.