summaryrefslogtreecommitdiff
path: root/docs/modules/migrate
diff options
context:
space:
mode:
authorDan Allen <dan.j.allen@gmail.com>2020-12-21 15:51:09 -0700
committerDan Allen <dan.j.allen@gmail.com>2020-12-21 15:58:57 -0700
commit4d2e89cb49755ff483a33a936ec404b287ce2e07 (patch)
tree69ac7d8ceb112bfefc2c7161312cebe1917e1781 /docs/modules/migrate
parent7b06b7c8dbaea09bf95cdd4120c46b688d55f227 (diff)
rename asciidoc-python.adoc to asciidoc-py and use AsciiDoc.py to refer to original processor
Diffstat (limited to 'docs/modules/migrate')
-rw-r--r--docs/modules/migrate/nav.adoc2
-rw-r--r--docs/modules/migrate/pages/asciidoc-py.adoc (renamed from docs/modules/migrate/pages/asciidoc-python.adoc)9
-rw-r--r--docs/modules/migrate/pages/upgrade.adoc2
3 files changed, 6 insertions, 7 deletions
diff --git a/docs/modules/migrate/nav.adoc b/docs/modules/migrate/nav.adoc
index 6df6ade3..2c35826a 100644
--- a/docs/modules/migrate/nav.adoc
+++ b/docs/modules/migrate/nav.adoc
@@ -1,6 +1,6 @@
* Migration Guides
** xref:upgrade.adoc[]
-** xref:asciidoc-python.adoc[]
+** xref:asciidoc-py.adoc[]
** xref:docbook-xml.adoc[]
** xref:markdown.adoc[]
** xref:confluence-xhtml.adoc[]
diff --git a/docs/modules/migrate/pages/asciidoc-python.adoc b/docs/modules/migrate/pages/asciidoc-py.adoc
index 3a1728dc..a5f1cac8 100644
--- a/docs/modules/migrate/pages/asciidoc-python.adoc
+++ b/docs/modules/migrate/pages/asciidoc-py.adoc
@@ -1,17 +1,16 @@
-= Migrate from AsciiDoc.py to Asciidoctor
-:navtitle: Migrate from AsciiDoc.py
+= Migrate from AsciiDoc.py
:url-diagram: {url-org}/asciidoctor-diagram
:url-tests: {url-org}/asciidoctor/tree/master/test
:url-doctest: {url-org}/asciidoctor-doctest
:url-manpage: {url-project}/man/asciidoctor
//:uri-diffs: {uri-home}/docs/asciidoc-asciidoctor-diffs/
-// um anchor: migrating-from-asciidoc-python
-If you're currently using AsciiDoc.py (aka AsciiDoc Python) to convert your AsciiDoc documents and want to switch to Asciidoctor, you'll need to migrate your legacy AsciiDoc content to the official AsciiDoc syntax defined and supported by Asciidoctor.
+AsciiDoc.py (aka AsciiDoc Python) is the original AsciiDoc processor, which has now been superseded by Asciidoctor.
+If you're currently using AsciiDoc.py to convert your AsciiDoc documents and are ready to switch to Asciidoctor, you'll need to migrate your legacy AsciiDoc content to the official AsciiDoc syntax defined and supported by Asciidoctor.
In doing so, you'll also benefit from the enhancements that have been added to the AsciiDoc language since Asciidoctor took over development of the language.
This page covers those differences and how to migrate.
-NOTE: This documentation specifically covers migration from AsciiDoc.py 8 to the latest stable version of Asciidoctor.
+NOTE: This documentation specifically covers migration from AsciiDoc.py 8.6.
== Processor call
diff --git a/docs/modules/migrate/pages/upgrade.adoc b/docs/modules/migrate/pages/upgrade.adoc
index 7fae3f9b..6a270979 100644
--- a/docs/modules/migrate/pages/upgrade.adoc
+++ b/docs/modules/migrate/pages/upgrade.adoc
@@ -1,7 +1,7 @@
= Upgrade from Asciidoctor 1.5.x to 2.0
IMPORTANT: This page if for users upgrading from a previous version of Asciidoctor to the latest stable version of Asciidoctor.
-If your migrating from AsciiDoc Python, see xref:asciidoc-python.adoc[].
+If your migrating from AsciiDoc.py, see xref:asciidoc-py.adoc[].
When you upgrade Asciidoctor you may also need to update some of the syntax and attributes in your AsciiDoc documents.
Major version releases can include new AsciiDoc syntax capabilities as well as syntax changes that make it more consistent.