Update articles.welcome.xml

Simplify welcome article, make it less idiomatic and ambiguous before the translators get involved.
textpattern · Aug 8, 2018 · 1a89451 · 1a89451
1 parent d098689
commit 1a89451
Showing 1 changed file with 16 additions and 14 deletions.
diff --git a/textpattern/setup/articles/articles.welcome.xml b/textpattern/setup/articles/articles.welcome.xml
@@ -8,25 +8,27 @@
     <category>meaningful-labor</category>
     <body format="textile"><![CDATA[h3. What do you want to do next?
 
-* Modify or delete this article? The "article list":adminurl/index.php?event=list is the place to start.
-* Change this site's name, or select a different URL style of the URLs? It's all up to your "preferences":adminurl/index.php?event=prefs.
-* Get yourself acquainted with Textile, the humane markup generator which comes with Textpattern? The basics are "simple":https://textpattern.com/textile-sandbox. If you want to learn more, you can dig into an "extensive manual":https://textpattern.com/textile-reference-manual later.
-* Be guided through your "Textpattern first steps":https://textpattern.com/textpattern-first-steps by completing some basic tasks?
+* Edit or delete this article? The "article list":adminurl/index.php?event=list is the place to start.
+* Change this site's name, or select a different URL style? It's all up to your "preferences":adminurl/index.php?event=prefs.
+* Learn Textile, the markup generator included with Textpattern? The basics are "simple":https://textpattern.com/textile-sandbox. If you want to learn more, you can refer to an extensive "Textile manual":https://textpattern.com/textile-reference-manual later.
+* Be guided through your "Textpattern first steps":https://textpattern.com/textpattern-first-steps by completing some tasks?
 * Study the "Textpattern Semantic Model?":https://textpattern.com/textpattern-semantic-model
-* Add one or more "additional users":adminurl/index.php?event=admin, or extend Textpattern's capabilities with "plugins":adminurl/index.php?event=plugin you discovered from the "Textpattern plugin directory?":https://textpattern.com/plugins
-* Dive in and learn by doing? Then please note:
+* Add one or more "additional users":adminurl/index.php?event=admin, or extend Textpattern's capabilities with "plugins":adminurl/index.php?event=plugin from the "Textpattern plugin directory?":https://textpattern.com/plugins
+* Dive in and learn by doing? Please note:
 ** When you "write an article":adminurl/index.php?event=article you assign it to a section of your site.
-** Sections use a "page template":adminurl/index.php?event=page and a "style":adminurl/index.php?event=css as an output scaffold.
-** Page templates use HTML(HyperText Markup Language) and "Textpattern tags":https://docs.textpattern.io/tags/ (like this: @<txp:article />@) to build the markup.
-** Some Textpattern tags use "forms":adminurl/index.php?event=form, which are building blocks for reusable snippets of code and markup you may build and use at your discretion.
-** Pages, forms and styles can be combined into "themes":adminurl/index.php?event=skin that can be assigned to one or more sections.
+** Sections use a "page template":adminurl/index.php?event=page and a "style":adminurl/index.php?event=css to define how it appears in a browser.
+** Page templates use HTML(HyperText Markup Language) and "Textpattern tags":https://docs.textpattern.io/tags/ (like this: @<txp:article />@) to build the output code.
+** Some Textpattern tags use "forms":adminurl/index.php?event=form, which are building blocks for reusable code and markup.
+** Pages, styles and forms can be packaged into "themes":adminurl/index.php?event=skin and assigned to one or more sections.
 
-Textpattern tags, their attributes and values are explained and sampled within the "Textpattern User Documentation":https://docs.textpattern.io/, where you will also find valuable tips and tutorials.
+Textpattern tags, their attributes and values are explained within the "Textpattern User Documentation":https://docs.textpattern.io/, where you will also find valuable examples, advice and tutorials.
 
-There's also a crowd of friendly, helpful people over at the "Textpattern support forum":https://forum.textpattern.io/. Come and pay a visit!
+There's also a group of friendly, helpful Textpattern users and administrators at the "Textpattern support forum":https://forum.textpattern.io/.
 
-We welcome additional language translations (and corrections to current translations). Please visit "Textpattern language translations":https://textpattern.com/languages for further details.]]></body>
-    <excerpt format="textile"><![CDATA[This is a Textpattern article excerpt. Article excerpts are optional but can be used effectively to summarize an article's content, for example with Textpattern's built-in article syndication and with the @<txp:excerpt />@ tag.]]></excerpt>
+Additional language translations and corrections are welcomed. Please visit "Textpattern language translations":https://textpattern.com/languages for further details.
+
+This is an example article included with Textpattern CMS to demonstrate some of the first steps you can undertake. It can be safely deleted.]]></body>
+    <excerpt format="textile"><![CDATA[This is a Textpattern article excerpt. Article excerpts are optional and can be used effectively to summarize an article's content, for example with Textpattern's built-in article syndication.]]></excerpt>
     <comment>
         <name>Donald Swain</name>
         <email>donald-swain@example.com</email>