# Non-friendly documentation

**URL:** https://discourse.julialang.org/t/non-friendly-documentation/38109
**Category:** New to Julia
**Tags:** question, documentation
**Created:** [April 23, 2020, 9:24pm UTC](https://discourse.julialang.org/t/non-friendly-documentation/38109 "2020-04-23T21:24:33Z")
**Posts on this page:** 1
**Showing post:** 135

<div class="post-metadata">

### Author: ![PetrKryslUCSD](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/petrkryslucsd/32/215825_2.png) [@PetrKryslUCSD](https://discourse.julialang.org/u/PetrKryslUCSD)
#### Post date: [September 18, 2020, 3:22pm UTC](https://discourse.julialang.org/t/non-friendly-documentation/38109/135 "2020-09-18T15:22:03Z")

</div>

I would like to point out that I found the Julia manual helpful when I started using it.  
But in truth some of the things made sense only a long way down the road, and  
some I skipped, at least initially.

In my opinion the manual **blurs together the four kinds of user documentation** , with attendant reduction in efficiency. In other words, the four “boxes”

 ![image](https://global.discourse-cdn.com/julialang/original/3X/5/8/588cef409b815b8f325c3fa9985dbeecc94dd03f.png)  
are visited in this single document with little or no separation.

I personally try to follow in my own packages  
the view of the sw documentation outlined here:  
[https://documentation.divio.com/](https://documentation.divio.com/) (I have no stake in this effort.)

I am sure the separation of the present documentation into tutorials, how-to guides, explanations, and reference would be a non-trivial effort. But I for one am willing  
to help. Writing parts of the documentation is a great opportunity for  
Julia users to learn the language better, IMO.

---

_[View the full topic](https://discourse.julialang.org/t/non-friendly-documentation/38109)._