[GR-13136] Replace broken links caused by missing PolyglotEmbeddings.md

PullRequest: graal/2698

sdk/README.md

@@ -10,7 +10,7 @@ The Graal SDK is a collection of APIs for the components of GraalVM.
 
 1. Download GraalVM from [Oracle Technology Network](http://www.oracle.com/technetwork/oracle-labs/program-languages/overview/).
 2. Use any of the Java executables in `./bin` or import GraalVM as JDK in your favorite IDE.
-3. Use Graal-SDK, the jar is put on the class path for you automatically. 
+3. Use Graal-SDK, the jar is put on the class path for you automatically.
 
 The Graal-SDK bits are also uploaded to Maven central.
 You can use it from your `pom.xml` file as:
@@ -29,7 +29,7 @@ Please note that Graal SDK requires GraalVM to run.
 
 ## Tutorials
 
-* [Tutorial](./docs/PolyglotEmbedding.md) on using the polyglot API to embed Graal languages in Java host applications.
+* [Tutorial](http://www.graalvm.org/docs/graalvm-as-a-platform/embed/) on using the polyglot API to embed Graal languages in Java host applications.
 
 ## Changes
 
@@ -38,4 +38,4 @@ Important API changes and additions are tracked in the [SDK changelog](./CHANGEL
 
 ## License
 
-[Graal SDK](../sdk) is licensed under the [Universal Permissive License](./LICENSE.md).
+[Graal SDK](../sdk) is licensed under the [Universal Permissive License](./LICENSE.md).

truffle/README.md

@@ -3,7 +3,7 @@
 ## Introduction
 
 Truffle is an Open Source library for building programming language implementations as interpreters for self-modifying Abstract Syntax Trees.
-Together with the Open Source [Graal compiler](../compiler), Truffle represents a significant step 
+Together with the Open Source [Graal compiler](../compiler), Truffle represents a significant step
 forward in programming language implementation technology in the current era of dynamic languages.
 
 A growing  body of shared implementation code and services
@@ -47,7 +47,7 @@ SimpleLanguage is well documented and designed to demonstrate most of the Truffl
 * Start with a new subclass of [TruffleInstrument](http://www.graalvm.org/truffle/javadoc/com/oracle/truffle/api/instrumentation/TruffleInstrument.html) for your own instrumentation/tool.
 * Fork [SimpleLanguage](https://github.com/graalvm/simplelanguage), a toy language that demonstrates how to use most Truffle features.
 * Get inspired by looking at code of one of existing open source Truffle language implementations and experiments [here](./docs/Languages.md).
-* Embed Truffle languages in Java host applications using the [Polyglot API](../sdk/docs/PolyglotEmbedding.md).
+* Embed Truffle languages in Java host applications using the [Polyglot API](http://www.graalvm.org/docs/graalvm-as-a-platform/embed/).
 * Read The Graal/Truffle [publications](../docs/Publications.md)
 * Verify that your language is a valid polyglot citizen using the [Polyglot TCK](./docs/TCK.md).
 
@@ -60,7 +60,7 @@ As a best practice it is recommended to upgrade Truffle only one version at a ti
 This way you can increment the version, fix deprecation warnings to continue with the next version.
 The deprecated Javadoc tags on the deprecated APIs are designed to be a guide on how to upgrade.
 
-The latest additions and changes can be seen in the [changelog](./CHANGELOG.md). 
+The latest additions and changes can be seen in the [changelog](./CHANGELOG.md).
 
 ## Hacking Truffle
 
@@ -81,7 +81,7 @@ sources from a command line:
 $ mx clean
 $ mx build
 $ mx unittest
-``` 
+```
 
 The created `./build` directory contains all necessary jars and source bundles.
 

truffle/docs/LanguageTutorial.md

@@ -13,6 +13,5 @@ Conference on Programming Language Design and Implementation [PLDI 2016](http://
 Next Steps:
 * Start to subclass [TruffleLanguage](http://www.graalvm.org/truffle/javadoc/com/oracle/truffle/api/TruffleLanguage.html) for your own language implementation.
 * Fork [SimpleLanguage](https://github.com/graalvm/simplelanguage), a toy language that demonstrates how to use many Truffle features.
-* Embed Truffle languages in Java host applications using the [Polyglot API](../../sdk/docs/PolyglotEmbedding.md).
+* Embed Truffle languages in Java host applications using the [Polyglot API](http://www.graalvm.org/docs/graalvm-as-a-platform/embed/).
 * Read The Graal/Truffle [publications](../../docs/Publications.md)
-

truffle/docs/Languages.md

@@ -2,14 +2,14 @@ This page is intended to keep track of the growing number of Truffle language im
 
 ## Language implementations
 
-* [Graal.js](http://www.oracle.com/technetwork/oracle-labs/program-languages/overview/index.html), an ECMAScript 2017 compliant JavaScript implementation. *
+* [Graal.js](https://github.com/graalvm/graaljs), an ECMAScript 2017 compliant JavaScript implementation. *
 * [FastR](https://github.com/graalvm/fastr), an implementation of GNU R. *
 * [TruffleRuby](https://github.com/graalvm/truffleruby), an implementation of Ruby. *
-* [Sulong](https://github.com/oracle/graal/sulong), an LLVM bitcode interpreter. *
-* [Graal.Python](http://www.oracle.com/technetwork/oracle-labs/program-languages/overview/index.html), an early-stage implementation of Python. * 
-* [TruffleSOM](https://github.com/SOM-st/TruffleSOM), a SOM Smalltalk implementation. 
+* [Sulong](https://github.com/oracle/graal/tree/master/sulong), an LLVM bitcode interpreter. *
+* [Graal.Python](https://github.com/graalvm/graalpython), an early-stage implementation of Python. *
+* [TruffleSOM](https://github.com/SOM-st/TruffleSOM), a SOM Smalltalk implementation.
 * [SOMns](https://github.com/smarr/SOMns), a Newspeak implementation for Concurrency Research.
-* [SimpleLanguage](https://github.com/graalvm/simplelanguage), a toy language implementation to demonstrate Truffle features. 
+* [SimpleLanguage](https://github.com/graalvm/simplelanguage), a toy language implementation to demonstrate Truffle features.
 
 \* Shipped as part of [GraalVM](http://www.oracle.com/technetwork/oracle-labs/program-languages/overview/index.html).
 
@@ -22,7 +22,7 @@ This page is intended to keep track of the growing number of Truffle language im
 * [hextruffe](https://bitbucket.org/hexafraction/truffles), an implementation of Hex.
 * [TruffleMATE](https://github.com/charig/TruffleMATE), a Smalltalk with a completely reified runtime system.
 * [PureScript](https://github.com/slamdata/truffled-purescript), a small strongly typed programming language.
-* [Mozart-Graal](https://github.com/eregon/mozart-graal), an implementation of the Oz programming language. 
+* [Mozart-Graal](https://github.com/eregon/mozart-graal), an implementation of the Oz programming language.
 * [DynSem](https://github.com/metaborg/dynsem), a DSL for declarative specification of dynamic semantics of languages.
 * [Cover](https://github.com/gerard-/cover), a Safe Subset of C++.
 * [TrufflePascal](https://github.com/Aspect26/TrufflePascal/), a Pascal interpreter.