Skip to content

Commit

Permalink
remove reference to FIRST_STEPS.md, now subsumed into INSTALLATION.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ablaom committed May 30, 2024
1 parent 2fcfcf5 commit e1cd316
Show file tree
Hide file tree
Showing 4 changed files with 37 additions and 62 deletions.
2 changes: 1 addition & 1 deletion DEVELOPER_NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ All tutorials use a common Project.toml/Manifest.toml pair, located at
the root level.

**IMPORTANT** Always ensure the version of Julia used to generate this pair matches what
is declared in `/FIRST_STEPS.md`. This needs to match `JULIA_VERSION` defined in
is declared in `INSTALLATION.md`. This needs to match `JULIA_VERSION` defined in
src/HelloJulia.jl.


Expand Down
19 changes: 0 additions & 19 deletions FIRST_STEPS.md

This file was deleted.

6 changes: 2 additions & 4 deletions INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,10 +55,8 @@ workshop!

## Running the demos and tutorials

!!! Note

Running notebooks for the first time may involve delays due to
precompilation of newly installed packages.
**Note.** Running notebooks for the first time may involve delays due to precompilation of
newly installed packages.

After starting a new Julia session, enter these commands:

Expand Down
72 changes: 34 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,11 +56,41 @@ Some random resources for Julia newcomers:
Julia](https://juliaai.github.io/DataScienceTutorials.jl/)


## First steps
## Other ways to learn Julia

- [Installing Julia on my computer](/FIRST_STEPS.md)
### If you have little or no prior programming experience

- [HelloJulia demos and tutorials](INSTALLATION.md)
Many people use R, python or MATLAB packages with a minimum of actual
programming knowledge and the same applies to Julia. However, to start
deepening your Julia programming knowledge, you could try some of the
resources at this [Julia org page](https://julialang.org/learning/)
(e.g., [juliaAcademy](https://juliaacademy.com)). I have also heard
that the book [Think
Julia](https://benlauwens.github.io/ThinkJulia.jl/latest/book.html) is
a pretty good ab initio introduction to programming.


### If you have moderate to advanced programming experience elsewhere

If you are already python proficient, check out
[this](https://colab.research.google.com/drive/1G04w8tTl074180DP_Ka9X44r_pndUYxq?usp=sharing#scrollTo=9at61Y3LLJWX)
Colab notebook.

My strong recommendation would be to read Aaron Christinson's tutorial
[Dispatching Design
Patterns](https://github.com/ninjaaron/dispatching-design-patterns)
which is nicely compressed in his [half-hour
video presentation](https://www.youtube.com/watch?v=n-E-1-A_rZM).

These [points of
difference](https://docs.julialang.org/en/v1/manual/noteworthy-differences/)
between Julia and other popular languages may also be useful.

Serious Julia developers will want a copy of [Hands-On Design Patterns
and Best Julia Practices with Julia](https://www.perlego.com/book/1365831/handson-design-patterns-and-best-practices-with-julia-proven-solutions-to-common-problems-in-software-design-for-julia-1x-pdf?utm_source=google&utm_medium=cpc&gclid=CjwKCAjw_L6LBhBbEiwA4c46uv-v5MDWoUCnOsWjAsPQ1OWcownNPPDrKDhhlwNbGG69_zSNFwyM5RoCMgcQAvD_BwE) by Tom Kwong. This is the book
I wished existed when I started. I learned Julia from the
[manual](https://docs.julialang.org/en/v1/) which is, however,
excellent.


## Advanced setup
Expand All @@ -79,6 +109,7 @@ Once you are familiar with basic interaction using the REPL, you will want to:
- Juptyer notebooks (used also for R and python) - follow [these
instructions](https://github.com/JuliaLang/IJulia.jl).
- [Pluto](https://github.com/fonsp/Pluto.jl) "reactive" notebooks (specific to Julia)
These formats are also provided by the HelloJulia.jl [tutorials](INSTALLATION.md).


## Getting help
Expand All @@ -99,41 +130,6 @@ channel](https://julialang.org/slack/). Also useful:
- `apropos("invert")` seaches for objects with "invert" in the doc string.


## Learning Julia

### If you have little or no prior programming experience

Many people use R, python or MATLAB packages with a minimum of actual
programming knowledge and the same applies to Julia. However, to start
deepening your Julia programming knowledge, you could try some of the
resources at this [Julia org page](https://julialang.org/learning/)
(e.g., [juliaAcademy](https://juliaacademy.com)). I have also heard
that the book [Think
Julia](https://benlauwens.github.io/ThinkJulia.jl/latest/book.html) is
a pretty good ab initio introduction to programming.


### If you have moderate to advanced programming experience elsewhere

If you are already python proficient, check out
[this](https://colab.research.google.com/drive/1G04w8tTl074180DP_Ka9X44r_pndUYxq?usp=sharing#scrollTo=9at61Y3LLJWX)
Colab notebook.

My strong recommendation would be to read Aaron Christinson's tutorial
[Dispatching Design
Patterns](https://github.com/ninjaaron/dispatching-design-patterns)
which is nicely compressed in his [half-hour
video presentation](https://www.youtube.com/watch?v=n-E-1-A_rZM).

These [points of
difference](https://docs.julialang.org/en/v1/manual/noteworthy-differences/)
between Julia and other popular languages may also be useful.

Serious Julia developers will want a copy of [Hands-On Design Patterns
and Best Julia Practices with Julia](https://www.perlego.com/book/1365831/handson-design-patterns-and-best-practices-with-julia-proven-solutions-to-common-problems-in-software-design-for-julia-1x-pdf?utm_source=google&utm_medium=cpc&gclid=CjwKCAjw_L6LBhBbEiwA4c46uv-v5MDWoUCnOsWjAsPQ1OWcownNPPDrKDhhlwNbGG69_zSNFwyM5RoCMgcQAvD_BwE) by Tom Kwong. This is the book
I wished existed when I started. I learned Julia from the
[manual](https://docs.julialang.org/en/v1/) which is, however,
excellent.

**Acknowledgements.** Some slides used in the presentation for this
workshop, and included [here](/slides), are based on material
Expand Down

0 comments on commit e1cd316

Please sign in to comment.