diff --git a/doc/BBCode.md b/doc/BBCode.md
index 5aa33fd81b..803f716aeb 100644
--- a/doc/BBCode.md
+++ b/doc/BBCode.md
@@ -148,15 +148,20 @@ This require "openstreetmap" addon version 1.3 or newer.
Abstract for longer posts
-------------------------
-If you want to spread your post to several third party networks you can have the problem that these networks have (for example) a length limitation. (Like on Twitter)
+If you want to spread your post to several third party networks you can have the problem that these networks have (for example) a length limitation.
+(Like on Twitter)
-Friendica is using a semi intelligent mechanism to generate a fitting abstract. But it can be interesting to define an own abstract that will only be displayed on the external network. This is done with the [abstract]-element. Example:
+Friendica is using a semi intelligent mechanism to generate a fitting abstract.
+But it can be interesting to define an own abstract that will only be displayed on the external network.
+This is done with the [abstract]-element.
+Example:
[abstract]Totally interesting! A must-see! Please click the link![/abstract]
I want to tell you a really boring story that you really never wanted
to hear.
-Twitter would display the text "Totally interesting! A must-see! Please click the link!". On Friendica you would only see the text after "I want to tell you a really ..."
+Twitter would display the text "Totally interesting! A must-see! Please click the link!".
+On Friendica you would only see the text after "I want to tell you a really ..."
It is even possible to define abstracts for separate networks:
@@ -173,7 +178,9 @@ For Twitter and App.net the system will use the defined abstracts. For other net
If you use (for example) the "buffer" connector to post to Facebook or Google+ you can use this element to define an abstract for a longer blogpost that you don't want to post completely to these networks.
-Networks like Facebook or Google+ aren't length limited. For this reason the [abstract] element isn't used. Instead you have to name the explicit network:
+Networks like Facebook or Google+ aren't length limited.
+For this reason the [abstract] element isn't used.
+Instead you have to name the explicit network:
[abstract]These days I had a strange encounter ...[abstract]
@@ -183,7 +190,8 @@ newest blog post![abstract]
really cool.[abstract]
While taking pictures in the woods I had a really strange encounter ...
-The [abstract] element isn't working with the native OStatus connection or with connectors where we post the HTML. (Like Tumblr, Wordpress or Pump.io)
+The [abstract] element isn't working with the native OStatus connection or with connectors where we post the HTML.
+(Like Tumblr, Wordpress or Pump.io)
Special
-------
diff --git a/doc/de/BBCode.md b/doc/de/BBCode.md
index 5f24fa2b61..cd9fa7673e 100644
--- a/doc/de/BBCode.md
+++ b/doc/de/BBCode.md
@@ -147,9 +147,13 @@ oder eine Adresse in obiger Form verwendet werden.
Zusammenfassung für längere Beiträge
------------------------------------
-Wenn man seine Beiträge über mehrere Netzwerke verbreiten möchte, hat man häufig das Problem, dass diese Netzwerke z.B. eine Längenbeschränkung haben. (Z.B. Twitter).
+Wenn man seine Beiträge über mehrere Netzwerke verbreiten möchte, hat man häufig das Problem, dass diese Netzwerke z.B. eine Längenbeschränkung haben.
+(Z.B. Twitter).
-Friendica benutzt zum Erzeugen eines Anreißtextes eine halbwegs intelligente Logik. Es kann aber dennoch von Interesse sein, eine eigene Zusammenfassung zu erstellen, die nur auf dem Fremdnetzwerk dargestellt wird. Dies geschieht mit dem [abstract]-Element. Beispiel:
+Friendica benutzt zum Erzeugen eines Anreißtextes eine halbwegs intelligente Logik.
+Es kann aber dennoch von Interesse sein, eine eigene Zusammenfassung zu erstellen, die nur auf dem Fremdnetzwerk dargestellt wird.
+Dies geschieht mit dem [abstract]-Element.
+Beispiel:
[abstract]Total spannend! Unbedingt diesen Link anklicken![/abstract]
Hier erzähle ich euch eine total langweilige Geschichte, die ihr noch
@@ -166,11 +170,13 @@ Es ist sogar möglich, für einzelne Netzwerke eigene Zusammenfassungen zu erste
Ich war heute wieder im Wald unterwegs und habe tolle Bilder geschossen ...
-Für Twitter und App.net nimmt das System die entsprechenden Texte. Bei anderen Netzwerken, bei denen der Inhalt gekürzt wird (z.B. beim "statusnet"-Connector, der für das Posten nach GNU Social verwendet wird) wird dann die Zusammenfassung unter [abstract] verwendet.
+Für Twitter und App.net nimmt das System die entsprechenden Texte.
+Bei anderen Netzwerken, bei denen der Inhalt gekürzt wird (z.B. beim "statusnet"-Connector, der für das Posten nach GNU Social verwendet wird) wird dann die Zusammenfassung unter [abstract] verwendet.
Wenn man z.B. den "buffer"-Connector verwendet, um nach Facebook oder Google+ zu posten, kann man dieses Element ebenfalls verwenden, wenn man z.B. einen längeren Blogbeitrag erstellt hat, aber ihn nicht komplett in diese Netzwerke posten möchte.
-Netzwerke wie Facebook oder Google+ sind nicht in der Postinglänge beschränkt. Aus diesem Grund greift nicht die [abstract]-Zusammenfassung. Stattdessen muss man das Netzwerk explizit angeben:
+Netzwerke wie Facebook oder Google+ sind nicht in der Postinglänge beschränkt.
+Aus diesem Grund greift nicht die [abstract]-Zusammenfassung. Stattdessen muss man das Netzwerk explizit angeben:
[abstract]Ich habe neulich wieder etwas erlebt, was ich euch mitteilen möchte.[abstract]