From 19d7ef59306c4a6b79a8096e5086aa275495050d Mon Sep 17 00:00:00 2001 From: Sascha Mann Date: Thu, 2 Feb 2017 22:26:52 +0100 Subject: [PATCH 1/2] Add track documentation --- docs/ABOUT.md | 12 ++++++++++++ docs/INSTALLATION.md | 2 ++ docs/RESOURCES.md | 6 ++++++ 3 files changed, 20 insertions(+) diff --git a/docs/ABOUT.md b/docs/ABOUT.md index e69de29bb2d1d..8f011a9edf135 100644 --- a/docs/ABOUT.md +++ b/docs/ABOUT.md @@ -0,0 +1,12 @@ +Julia is an open-source high-level, high-performance dynamic programming language designed for technical and scientific computing while also being effective for general-purpose tasks. It is convenient to use for daily work but also runs fast enough to be deployed for high-performance applications. + +Interesting features include: +- Large parts of [Julia's base library](https://github.com/julialang/julia) are written in Julia itself. Understanding and contributing to the Julia core does not require knowledge of another language. +- Easy to use interfaces to call libraries written in other languages, such as [C, Fortran](http://docs.julialang.org/en/stable/manual/calling-c-and-fortran-code/) and [Python](https://github.com/JuliaPy/PyCall.jl), directly. +- [Multiple dispatch](http://docs.julialang.org/en/stable/manual/methods/#man-methods) +- A dynamic, nominative and parametric [type system](http://docs.julialang.org/en/stable/manual/types/). +- Homoiconicity: Julia code can be represented in Julia itself, making it a good language to get into [metaprogramming](http://docs.julialang.org/en/stable/manual/metaprogramming/). + +The first public release was in 2012. You can find out more about the motivation behind it in the blog post ["Why We Created Julia"](http://julialang.org/blog/2012/02/why-we-created-julia) by the core developers. + +Despite its young age, Julia is already being used in the real world in a variety of fields, such as but not limited to Finance, Data Science and Scientific Computing. You can find many showcase applications on [juliabloggers.com](http://www.juliabloggers.com/) and a list of publications about the language and its technical computing applications [here](http://julialang.org/publications/). diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md index 5e646e175c1af..7196c7a5ee236 100644 --- a/docs/INSTALLATION.md +++ b/docs/INSTALLATION.md @@ -1,5 +1,7 @@ To install Julia on your system follow the instructions on the [Julia Language Downloads page](http://julialang.org/downloads/). +[JuliaPro](http://juliacomputing.com/products/juliapro.html) includes the latest stable version of Julia, the Juno IDE, a debugger, a Jupyter notebook environment and many of the most popular Julia packages. It is a convenient way to install everything you will need to get started. + For a local installation, it is recommended to use [Juno](http://junolab.org/). It's an IDE based on Atom and offers a powerful text editor as well as additional features for developing in Julia. Just follow the instructions on their website. A simple way to get started with Julia without the need of a local installation is [JuliaBox](http://junolab.org/), which is an online IDE based on Jupyter notebooks. You just access it from your browser, login and you can start solving exercises. diff --git a/docs/RESOURCES.md b/docs/RESOURCES.md index e69de29bb2d1d..8012df168e2ea 100644 --- a/docs/RESOURCES.md +++ b/docs/RESOURCES.md @@ -0,0 +1,6 @@ +- [Julia Style Guide](docs.julialang.org/en/stable/manual/style-guide/): Guide on how to write idiomatic Julia code. +- [Performance Tips](http://docs.julialang.org/en/stable/manual/performance-tips/): Techniques to speed up your programs. +- [Julia Manual](http://docs.julialang.org/en/stable/manual/introduction/): Additional explanations and examples. +- [juliabloggers.com](http://www.juliabloggers.com/): Aggregator of Julia blog posts. +- [Julia Discourse](https://discourse.julialang.org/): Discussions about the language. +- [Julia YouTube channel](https://www.youtube.com/user/JuliaLanguage): Archive of JuliaCon talks. From e148a9bc9e83a01440c63de350e196948c6bd5c3 Mon Sep 17 00:00:00 2001 From: Sascha Mann Date: Wed, 22 Feb 2017 15:27:52 +0100 Subject: [PATCH 2/2] Improve ABOUT.md phrasing --- docs/ABOUT.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ABOUT.md b/docs/ABOUT.md index 8f011a9edf135..9c09d58ec0db9 100644 --- a/docs/ABOUT.md +++ b/docs/ABOUT.md @@ -5,7 +5,7 @@ Interesting features include: - Easy to use interfaces to call libraries written in other languages, such as [C, Fortran](http://docs.julialang.org/en/stable/manual/calling-c-and-fortran-code/) and [Python](https://github.com/JuliaPy/PyCall.jl), directly. - [Multiple dispatch](http://docs.julialang.org/en/stable/manual/methods/#man-methods) - A dynamic, nominative and parametric [type system](http://docs.julialang.org/en/stable/manual/types/). -- Homoiconicity: Julia code can be represented in Julia itself, making it a good language to get into [metaprogramming](http://docs.julialang.org/en/stable/manual/metaprogramming/). +- Homoiconicity: Julia code can be represented in Julia itself, making it a good language to learn about [metaprogramming](http://docs.julialang.org/en/stable/manual/metaprogramming/). The first public release was in 2012. You can find out more about the motivation behind it in the blog post ["Why We Created Julia"](http://julialang.org/blog/2012/02/why-we-created-julia) by the core developers.