[GR-20548] Link titles improvements to render properly at graalvm.org.

PullRequest: graalpython/776

Author: olyagpl

doc/CONTRIBUTING.md

@@ -1,16 +1,12 @@
-### Contributing to the GraalVM Implementation of Python
+# Contributing GraalPython
 
 Thanks for considering to contribute! To get you started, here is a bit of
 information about the structure of this implementation.
 
-##### But first...
-
-You will need to sign the [Oracle Contributor
-Agreement](http://www.graalvm.org/community/contributors/) for us to be able to
+You will need to sign the [Oracle Contributor Agreement](http://www.graalvm.org/community/contributors/) for us to be able to
 merge your work.
 
-Please also take some time to review our [code of
-conduct](http://www.graalvm.org/community/conduct/) for contributors.
+Please also take some time to review our [code of conduct](http://www.graalvm.org/community/conduct/) for contributors.
 
 ##### Getting started
 
@@ -83,20 +79,24 @@ modules that we have adapted from C Python.
 ##### Debug options
 
 The GraalVM implementation of Python provides proper debug options. It is possible to either debug the Python code, using Chrome debugger,   
-or the java code, using your preferred IDE. 
+or the java code, using your preferred IDE.
 The following commands should be executed in a virtualenv environment, which provides a graalpython executable.
 
 For debug Python side code call this:
 
-```graalpython --inspect your_script.py ```
+```
+graalpython --inspect your_script.py
+```
 
 This will open a debug server, which can be accessed in Chrome Browser under URL `chrome://inspect`.
 
 For debugging java implemented code execute:
 
-```graalpython --experimental-options -debug-java your_script.py```
+```
+graalpython --experimental-options -debug-java your_script.py
+```
 
-The command will also start a debug server, which can be used in an IDE. If the IDE was initialized properly 
+The command will also start a debug server, which can be used in an IDE. If the IDE was initialized properly
 by using the command mentioned above, the existing `GraalDebug` run configuration can be used to debug.
 
 ### Advanced commands to develop and debug

doc/IMPLEMENTATION_DETAILS.md

@@ -1,4 +1,6 @@
-## Python's global thread state
+# Implementation Details
+
+## Python Global Thread State
 
 In CPython, each stack frame is allocated on the heap, and there's a global
 thread state holding on to the chain of currently handled exceptions (e.g. if
@@ -78,7 +80,7 @@ exception. Unlike CPython we do not use a stack of currently handled exceptions,
 instead we utilize the call stack of Java by always passing the current exception
 and holding on to the last (if any) in a local variable.
 
-## Abstract operations on Python objects
+## Abstract Operations on Python Objects
 
 Many generic operations on Python objects in CPython are defined in the header
 files `abstract.c` and `abstract.h`. These operations are widely used and their

doc/JYTHON.md

@@ -7,9 +7,9 @@ implementation of Python, in contrast, is only targeting Python 3.x.
 
 Nonetheless, there are certain features of Jython's Java integration that we can
 offer similarly. Some features are more expensive to offer, and thus are hidden
-behind a commandline flag, `--python.EmulateJython`.
+behind a command line flag, `--python.EmulateJython`.
 
-## Importing Java classes and packages
+## Importing Java Classes and Packages
 
 In the default mode, Java classes can only be imported through the `java`
 package. Additionally, only Java classes can be imported, not packages. In
@@ -44,12 +44,12 @@ speculative imports in the standard library), we ask the Java classloader to
 list currently available packages and traverse them to check if we should create
 a Java package. This slows down startup significantly.
 
-## Interacting with Java objects
+## Interacting with Java Objects
 
 Once you get hold of a Java object or class, interaction in both modes works
 naturally. Public fields and methods can be read and invoked as expected.
 
-## Subclassing Java classes and implementing interfaces with Python classes
+## Subclassing Java Classes and Implementing Interfaces with Python Classes
 
 This is not supported at all right now, there's no emulation available even in
 Jython compatibility mode. We have not seen many uses of this in the wild. Let

doc/POLYGLOT.md

@@ -1,6 +1,4 @@
-## Interop
-
-#### Interop from Python
+# Interoperability
 
 You can import the `polyglot` module to interact with other languages.