You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tinkerpop.apache.org by sp...@apache.org on 2015/11/09 23:09:12 UTC

incubator-tinkerpop git commit: Updates to new format of upgrade docs.

Repository: incubator-tinkerpop
Updated Branches:
  refs/heads/master bbc72d00c -> a9efe6542


Updates to new format of upgrade docs.

Basically, dropped out "Important Changes" and tried to fold those into subheadings elsewhere in the docs.


Project: http://git-wip-us.apache.org/repos/asf/incubator-tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-tinkerpop/commit/a9efe654
Tree: http://git-wip-us.apache.org/repos/asf/incubator-tinkerpop/tree/a9efe654
Diff: http://git-wip-us.apache.org/repos/asf/incubator-tinkerpop/diff/a9efe654

Branch: refs/heads/master
Commit: a9efe65429fd35ef6e4a2dfd7cea9bd1f260e951
Parents: bbc72d0
Author: Stephen Mallette <sp...@genoprime.com>
Authored: Mon Nov 9 17:08:20 2015 -0500
Committer: Stephen Mallette <sp...@genoprime.com>
Committed: Mon Nov 9 17:08:20 2015 -0500

----------------------------------------------------------------------
 .../upgrade-release-3.0.x-incubating.asciidoc   |  91 +++++++----
 .../upgrade-release-3.1.x-incubating.asciidoc   | 162 +++++++++++++------
 2 files changed, 181 insertions(+), 72 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-tinkerpop/blob/a9efe654/docs/src/upgrade-release-3.0.x-incubating.asciidoc
----------------------------------------------------------------------
diff --git a/docs/src/upgrade-release-3.0.x-incubating.asciidoc b/docs/src/upgrade-release-3.0.x-incubating.asciidoc
index 4251e66..4bb1473 100644
--- a/docs/src/upgrade-release-3.0.x-incubating.asciidoc
+++ b/docs/src/upgrade-release-3.0.x-incubating.asciidoc
@@ -27,23 +27,46 @@ TinkerPop 3.0.2
 
 *Release Date: October 19, 2015*
 
-Important Changes
-~~~~~~~~~~~~~~~~~
-
-* TinkerGraph can now be configured to support persistence, where TinkerGraph will try to load a graph from a specified
-location and calls to `close()` will save the graph data to that location.
-* There were a number of fixes to `gremlin-driver` that prevent protocol desynchronization when talking to Gremlin
-Server.
-* The Gremlin Server sub-protocol introduces a new "close" operation to explicitly close sessions.
-* `BulkLoaderVertexProgram` does now support arbitrary inputs (besides the `HadoopGraph`, which was already supported in
-version 3.0.1, `BulkLoaderVertexProgram` can now also read from any TP3 enabled graph, like `TinkerGraph` or `Neo4jGraph`).
-
 Please see the link:https://github.com/apache/incubator-tinkerpop/blob/3.0.2-incubating/CHANGELOG.asciidoc#tinkerpop-302-release-date-october-19-2015[changelog] for a complete list of all the modifications that are part of this release.
 
 Upgrading for Users
 ~~~~~~~~~~~~~~~~~~~
 
-Aside from learning about new features, users should not expect to find any changes in this release that will cause compile errors or other problems during upgrade.
+BulkLoaderVertexProgram (BLVP)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+`BulkLoaderVertexProgram` now supports arbitrary inputs (i addition to `HadoopGraph`, which was already supported in
+version 3.0.1-incubating). It can now also read from any TP3 enabled graph, like `TinkerGraph`
+or `Neo4jGraph`.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-814[TINKERPOP3-319],
+link:http://tinkerpop.incubator.apache.org/docs/3.0.2-incubating/#bulkloadervertexprogram[Reference Documentation - BLVP]
+
+TinkerGraph
+^^^^^^^^^^^
+
+TinkerGraph can now be configured to support persistence, where TinkerGraph will try to load a graph from a specified
+location and calls to `close()` will save the graph data to that location.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-828[TINKERPOP3-828],
+link:http://tinkerpop.incubator.apache.org/docs/3.0.2-incubating/#_configuration[Reference Documentation - TinkerGraph]
+
+Gremlin Driver and Server
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+There were a number of fixes to `gremlin-driver` that prevent protocol desynchronization when talking to Gremlin
+Server.
+
+On the Gremlin Server side, Websocket sub-protocol introduces a new "close" operation to explicitly close sessions.
+Prior to this change, sessions were closed in a more passive fashion (i.e. session timeout).  There were also so
+bug fixes around the protocol as it pertained to third-party drivers (e.g. python) using JSON for authentication.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-814[TINKERPOP3-814],
+link:https://issues.apache.org/jira/browse/TINKERPOP3-816[TINKERPOP3-816],
+link:https://issues.apache.org/jira/browse/TINKERPOP3-817[TINKERPOP3-817],
+link:https://issues.apache.org/jira/browse/TINKERPOP3-855[TINKERPOP3-855],
+link:https://issues.apache.org/jira/browse/TINKERPOP3-870[TINKERPOP3-870],
+link:https://issues.apache.org/jira/browse/TINKERPOP3-877[TINKERPOP3-877]
 
 Upgrading for Providers
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -59,28 +82,42 @@ session-based requests).  Prior to this change, there was no way to explicitly c
 closed by the server after timeout of activity.  This new "op" gives drivers the ability to close the session
 explicitly and as needed.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-849[TINKERPOP3-849] and the
-link:http://tinkerpop.incubator.apache.org/docs/3.0.2-incubating/#_opprocessors_arguments[documentation] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-849[TINKERPOP3-849],
+link:http://tinkerpop.incubator.apache.org/docs/3.0.2-incubating/#_opprocessors_arguments[Reference Documentation - OpProcessor]
 
 TinkerPop 3.0.1
 ---------------
 
 *Release Date: September 2, 2015*
 
-Important Changes
-~~~~~~~~~~~~~~~~~
-
-* Gremlin Server now supports a link:https://en.wikipedia.org/wiki/Simple_Authentication_and_Security_Layer[SASL-based] (Simple Authentication and Security Layer) authentication model and a default `SimpleAuthenticator` which implements the `PLAIN` SASL mechanism (i.e. plain text) to authenticate requests.  This gives Gremlin Server some basic security capabilities, especially when combined with its built-in SSL feature.
-* Gremlin Server now allows for a `Map` of values that can be returned from initialization scripts.  That `Map` will be used to set global bindings for the server. See this link:https://github.com/apache/incubator-tinkerpop/blob/3.0.1-incubating/gremlin-server/scripts/generate-modern.groovy[sample script] for an example.
-* The Neo4j plugin should now install properly on Windows operating systems.
-* For those who are interested in writing documentation for TinkerPop, there is now a `--dryRun` option that can be supplied to the `bin/process-docs.sh` command.  This command is useful in that it does not pre-process the documentation and execute the code samples within.  That step is time-intensive and therefore the `--dryRun` option can save a lot of time when editing the documentation, especially if there are only text or formatting changes to test.
-
 Please see the link:https://github.com/apache/incubator-tinkerpop/blob/3.0.1-incubating/CHANGELOG.asciidoc#tinkerpop-301-release-date-september-2-2015[changelog] for a complete list of all the modifications that are part of this release.
 
 Upgrading for Users
 ~~~~~~~~~~~~~~~~~~~
 
-Aside from learning about new features, users should not expect to find any changes in this release that will cause compile errors or other problems during upgrade.
+Gremlin Server
+^^^^^^^^^^^^^^
+
+Gremlin Server now supports a link:https://en.wikipedia.org/wiki/Simple_Authentication_and_Security_Layer[SASL-based] 
+(Simple Authentication and Security Layer) authentication model and a default `SimpleAuthenticator` which implements 
+the `PLAIN` SASL mechanism (i.e. plain text) to authenticate requests.  This gives Gremlin Server some basic security 
+capabilities, especially when combined with its built-in SSL feature.
+
+There have also been changes in how global variable bindings in Gremlin Server are established via initialization
+scripts.  The initialization scripts now allow for a `Map` of values that can be returned from those scripts.  
+That `Map` will be used to set global bindings for the server. See this 
+link:https://github.com/apache/incubator-tinkerpop/blob/3.0.1-incubating/gremlin-server/scripts/generate-modern.groovy[sample script] 
+for an example.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-576[TINKERPOP3-576] 
+
+Neo4j
+^^^^^
+
+Problems related to using `:install` to get the Neo4j plugin operating in Gremlin Console on Windows have been 
+resolved.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-804[TINKERPOP3-804]
 
 Upgrading for Providers
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -102,7 +139,7 @@ public interface MyGraph extends Graph{
 
 `MyGraphFactory` must contain the static `open` method that is normally expected by `GraphFactory`.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-778[TINKERPOP3-778] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-778[TINKERPOP3-778]
 
 GraphProvider.Descriptor Annotation
 +++++++++++++++++++++++++++++++++++
@@ -120,14 +157,14 @@ public final class HadoopGiraphGraphProvider extends HadoopGraphProvider {
 }
 ----
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-690[TINKERPOP3-690] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-690[TINKERPOP3-690] for more information.
 
 Semantics of Transaction.close()
 ++++++++++++++++++++++++++++++++
 
 There were some adjustments to the test suite with respect to how `Transaction.close()` was being validated.  For most providers, this will generally mean checking `OptOut` annotations for test renaming problems.  The error that occurs when running the test suite should make it apparent that a test name is incorrect in an `OptOut` if there are issues there.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-764[TINKERPOP3-764] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-764[TINKERPOP3-764] for more information.
 
 Graph Driver Providers
 ^^^^^^^^^^^^^^^^^^^^^^
@@ -140,4 +177,4 @@ authentication turned on and authentication is not required, so existing drivers
 additional change.  Drivers should however consider implementing this feature as it is likely that many users will
 want the security capabilities that it provides.
 
-Please read more about how to implement authentication link:http://tinkerpop.incubator.apache.org/docs/3.0.1-incubating/#_authentication[here].
+See: link:http://tinkerpop.incubator.apache.org/docs/3.0.1-incubating/#_authentication[Reference Documentation - Gremlin Server Authentication]

http://git-wip-us.apache.org/repos/asf/incubator-tinkerpop/blob/a9efe654/docs/src/upgrade-release-3.1.x-incubating.asciidoc
----------------------------------------------------------------------
diff --git a/docs/src/upgrade-release-3.1.x-incubating.asciidoc b/docs/src/upgrade-release-3.1.x-incubating.asciidoc
index b1b006d..99f2b59 100644
--- a/docs/src/upgrade-release-3.1.x-incubating.asciidoc
+++ b/docs/src/upgrade-release-3.1.x-incubating.asciidoc
@@ -27,6 +27,8 @@ TinkerPop 3.1.0
 
 *Release Date: NOT OFFICIALLY RELEASED YET*
 
+Please see the link:https://github.com/apache/incubator-tinkerpop/blob/3.1.0-incubating/CHANGELOG.asciidoc#XXXXXXXXXXXXXXXXXXXXXXXXXXXX[changelog-(NOT FINAL)] for a complete list of all the modifications that are part of this release.
+
 Additional upgrade information can be found here:
 
 * <<_tinkerpop_3_0_2,TinkerPop 3.0.2>>
@@ -39,27 +41,71 @@ Important Changes
 * `GraphStep` is no longer in `sideEffect`-package, but now in `map`-package as traversals support mid-traversal `V()`.
 * Traversals now support mid-traversal `V()`-steps. Graph system providers should ensure that a mid-traversal `V()` can leverage any suitable index.
 * The data type of `Operator` enums will now always be the highest common data type of the two given numbers, rather than the data type of the first number, as it's been before.
-* The Gephi Plugin has improved integration with Gephi, where manually inserting `store` steps to visualize a running traversal is no longer required.
-* Entire TinkerGraph instances can be serialized over Gryo.
 * Hadoop1 support has been dropped. Hadoop2 is now supported. Giraph and Spark can work over Hadoop2 YARN.
 * The implementation and semantics of `GraphTraversal.group()` has changed. The previous model is deprecated and renamed to `groupV3d0()`.
-* `Transaction.onReadWrite()` and `Transaction.onClose()` are now `ThreadLocal` settings
-* `PartitionStrategy` now supports `VertexProperty` such those properties can be added to partitions.
-* The Jackson library is now "shaded" and included in the `gremlin-shaded` module.
-* Configuration for Netty link:http://netty.io/wiki/native-transports.html[native transport] support in Gremlin Server.
-* The `Channelizer` implementation for Gremlin Driver can now be changed via configuration.
-* TinkerGraph is now serializable over Gryo so it is possible to request subgraphs via Gremlin Server (and `:remote`).
-
-Please see the link:https://github.com/apache/incubator-tinkerpop/blob/3.1.0-incubating/CHANGELOG.asciidoc#XXXXXXXXXXXXXXXXXXXXXXXXXXXX[changelog] for a complete list of all the modifications that are part of this release.
 
 Upgrading for Users
 ~~~~~~~~~~~~~~~~~~~
 
-Gremlin Structure
-^^^^^^^^^^^^^^^^^
+Shading Jackson
+^^^^^^^^^^^^^^^
+
+The Jackson library is now shaded to `gremlin-shaded`, which will allow Jackson to version independently without
+breaking compatibility with dependent libraries or with those who depend on TinkerPop.  The downside is that if a
+library depends on TinkerPop and uses the Jackson classes, those classes will no longer exist with the standard
+Jackson package naming.  They will have to shifted as follows:
+
+* `org.objenesis` becomes `org.apache.tinkerpop.shaded.objenesis`
+* `com.esotericsoftware.minlog` becomes `org.apache.tinkerpop.shaded.minlog`
+* `com.fasterxml.jackson` becomes `org.apache.tinkerpop.shaded.jackson`
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-835[TINKERPOP3-835]
+
+PartitionStrategy and VertexProperty
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+`PartitionStrategy` now supports partitioning within `VertexProperty`.  The `Graph` needs to be able to support
+meta-properties for this feature to work.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-333[TINKERPOP3-333]
+
+Gremlin Server and Epoll
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Gremlin Server provides a configuration option to turn on support for Netty
+link:http://netty.io/wiki/native-transports.html[native transport] on Linux, which has been shown to help improve
+performance.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-901[TINKERPOP3-901]
+
+Rebindings Deprecated
+^^^^^^^^^^^^^^^^^^^^^
+
+The notion of "rebindings" has been deprecated in favor of the term "aliases".  Alias is a better and more intuitive
+term than rebindings which should make it easier for newcomers to understand what they are for.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-913[TINKERPOP3-913],
+link:http://tinkerpop.incubator.apache.org/docs/3.1.0-incubating/#_aliases[Reference Documentation - Aliases]
+
+Configurable Driver Channelizer
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The Gremlin Driver now allows the `Channerlizer` to be supplied as a configuration, which means that custom
+implementations may be supplied.
+
+See: https://issues.apache.org/jira/browse/TINKERPOP3-680[TINKERPOP3-680]
+
+GraphSON and Strict Option
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The `GraphMLReader` now has a `strict` option on the `Builder` so that if a data type for a value is invalid in some
+way, GraphMLReader will simply skip that problem value. In that way, it is a bit more forgiving than before especially
+with empty data.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-756[TINKERPOP3-756]
 
 Transaction.close() Default Behavior
-++++++++++++++++++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The default behavior of `Transaction.close()` is to rollback the transaction.  This is in contrast to previous versions
 where the default behavior was commit.  Using rollback as the default should be thought of as a like a safer approach
@@ -68,7 +114,7 @@ to closing where a user must now explicitly call `commit()` to persist their mut
 See link:https://issues.apache.org/jira/browse/TINKERPOP3-805[TINKERPOP3-805] for more information.
 
 ThreadLocal Transaction Settings
-++++++++++++++++++++++++++++++++
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The `Transaction.onReadWrite()` and `Transaction.onClose()` settings now need to be set for each thread (if another
 behavior than the default is desired). For gremlin-server users that may be changing these settings via scripts.
@@ -77,30 +123,65 @@ changed for an in-session request they will now only apply to all future request
 
 See link:https://issues.apache.org/jira/browse/TINKERPOP3-885[TINKERPOP3-885]
 
-Hadoop-Gremlin Updates
-++++++++++++++++++++++
+Hadoop-Gremlin
+^^^^^^^^^^^^^^
 
 * Hadoop1 is no longer supported. Hadoop2 is now the only supported Hadoop version in TinkerPop.
 * Spark and Giraph have been split out of Hadoop-Gremlin into their own respective packages (Spark-Gremlin and Giraph-Gremlin).
 * The directory where application jars are stored in HDFS is now `hadoop-gremlin-x.y.z-libs`.
 ** This versioning is important so that cross-version TinkerPop use does not cause jar conflicts.
 
-Spark-Gremlin Updates
-+++++++++++++++++++++
+Spark-Gremlin
+^^^^^^^^^^^^^
 
 * Providers that wish to reuse a graphRDD can leverage the new `PersistedInputRDD` and `PersistedOutputRDD`.
 ** This allows the graphRDD to avoid serialization into HDFS for reuse. Be sure to enabled persisted `SparkContext` (see documentation).
 
-TinkerGraph-Gremlin Updates
-+++++++++++++++++++++++++++
+TinkerGraph Serialization
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
-* The `public static String` configurations have been renamed. The old `public static` variables have been deprecated.
+TinkerGraph is serializable over Gryo, which means that it can shipped over the wire from Gremlin Server.  This
+feature can be useful when working with remote subgraphs.
 
-Gremlin Process
-^^^^^^^^^^^^^^^
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-728[TINKERPOP3-728]
 
-Graph Traversal Updates
-+++++++++++++++++++++++
+Deprecation in TinkerGraph
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The `public static String` configurations have been renamed. The old `public static` variables have been deprecated.
+If the deprecated variables were being used, then convert to the replacements as soon as possible.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-926[TINKERPOP3-926]
+
+Deprecation in Gremlin-Groovy
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The closure wrappers classes `GFunction`, `GSupplier`, `GConsumer` have been deprecated. In Groovy, a closure can be
+specified using `as Function` and thus, these wrappers are not needed. Also, the `GremlinExecutor.promoteBindings()`
+method which was previously deprecated has been removed.
+
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-879[TINKERPOP3-879],
+link:https://issues.apache.org/jira/browse/TINKERPOP3-897[TINKERPOP3-897]
+
+Gephi Traversal Visualization
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The process for visualizing a traversal has been simplified.  There is no longer a need to "name" steps that will
+represent visualization points for Gephi.  It is possible to just "configure" a `visualTraversal` in the console:
+
+[source,text]
+gremlin> :remote config visualTraversal graph vg
+
+which creates a special `TraversalSource` from `graph` called `vg`.  The traversals created from `vg` can be used
+to `:submit` to Gephi.
+
+See: link:http://tinkerpop.incubator.apache.org/docs/3.1.0-SNAPSHOT/#gephi-plugin[Reference Documentation - Gephi]
+
+Alterations to GraphTraversal
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+There were a number of changes to `GraphTraversal`.  Many of the changes came by way of deprecation, but some semantics
+have changed as well:
 
 * `ConjunctionStrategy` has been renamed to `ConnectiveStrategy` (no other behaviors changed).
 * `ConjunctionP` has been renamed to `ConnectiveP` (no other behaviors changed).
@@ -117,19 +198,8 @@ Graph Traversal Updates
 * Both `GraphTraversal().mapKeys()` and `GraphTraversal.mapValues()` has been deprecated.
 ** Use `select(keys)` and `select(columns)`. However, note that `select()` will not unroll the keys/values. Thus, `mapKeys()` => `select(keys).unfold()`.
 
-Gremlin-Groovy Updates
-^^^^^^^^^^^^^^^^^^^^^^
-
-* The closure wrappers classes `GFunction`, `GSupplier`, `GConsumer` have been deprecated.
-** In Groovy, a closure can be specified using `as Function` and thus, these wrappers are not needed.
-* The `GremlinExecutor.promoteBindings()` method which was previously deprecated has been removed.
-
-
-Gremlin Console
-^^^^^^^^^^^^^^^
-
-Aliasing Remotes
-++++++++++++++++
+Aliasing Remotes in the Console
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The `:remote` command in Gremlin Console has a new `alias` configuration option.  This `alias` option allows
 specification of a set of key/value alias/binding pairs to apply to the remote.  In this way, it becomes possible
@@ -144,6 +214,8 @@ would allow "g" on the server to be referred to as "x".
 [source,text]
 :> x.E().label().groupCount()
 
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-914[TINKERPOP3-914]
+
 Upgrading for Providers
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -169,8 +241,8 @@ are supplied in `AbstractThreadLocalTransaction` and `AbstractThreadedTransactio
 * `doReadWrite` that should execute the read-write consumer.
 * `doClose` that should execute the close consumer.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-765[TINKERPOP3-765] and
-link:https://issues.apache.org/jira/browse/TINKERPOP3-885[TINKERPOP3-885] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-765[TINKERPOP3-765],
+link:https://issues.apache.org/jira/browse/TINKERPOP3-885[TINKERPOP3-885]
 
 Transaction.close() Default Behavior
 ++++++++++++++++++++++++++++++++++++
@@ -183,7 +255,7 @@ previously asserted the opposite (i.e. commit on close).  These tests have been
 
 If these tests were referenced in an `OptOut`, then their names should be updated.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-805[TINKERPOP3-805] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-805[TINKERPOP3-805]
 
 Graph Traversal Updates
 +++++++++++++++++++++++
@@ -201,7 +273,7 @@ Element Removal
 `Element.Exceptions.elementAlreadyRemoved` has been deprecated and test enforcement for consistency have been removed.
  Providers are free to deal with deleted elements as they see fit.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-297[TINKERPOP3-297] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-297[TINKERPOP3-297]
 
 VendorOptimizationStrategy Rename
 +++++++++++++++++++++++++++++++++
@@ -209,7 +281,7 @@ VendorOptimizationStrategy Rename
 The `VendorOptimizationStrategy` has been renamed to `ProviderOptimizationStrategy`.  This renaming is consistent
 with revised terminology for what were formerly referred to as "vendors".
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-876[TINKERPOP3-876] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-876[TINKERPOP3-876]
 
 GraphComputer Updates
 +++++++++++++++++++++
@@ -230,7 +302,7 @@ supported it is recommended that the upgrade to "aliases" be made as soon as pos
 the future.  Gremlin Server will not accept both parameters at the same time - a request must contain either one
 parameter or the other if either is supplied.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-913[TINKERPOP3-913] for more information.
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-913[TINKERPOP3-913]
 
 ThreadLocal Transaction Settings
 ++++++++++++++++++++++++++++++++
@@ -240,4 +312,4 @@ longer apply to all future requests. If the settings are changed for a sessionle
 that one request. If the settings are changed from an in-session request they will only apply to all future requests
 made in the scope of that session.
 
-See link:https://issues.apache.org/jira/browse/TINKERPOP3-885[TINKERPOP3-885] for more information.
\ No newline at end of file
+See: link:https://issues.apache.org/jira/browse/TINKERPOP3-885[TINKERPOP3-885]
\ No newline at end of file