# AlgebraOfGraphics documentation frustrations

**URL:** <https://discourse.julialang.org/t/algebraofgraphics-documentation-frustrations/133903>\
**Category:** General Usage\
**Tags:** algebraofgraphics\
**Created:** [November 15, 2025, 7:13pm UTC](https://discourse.julialang.org/t/algebraofgraphics-documentation-frustrations/133903 "2025-11-15T19:13:47Z")\
**Posts on this page:** 1\
**Showing post:** 45

<div class="post-metadata">

**Author:** ![Eben60](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/eben60/32/13475_2.png) [@Eben60](https://discourse.julialang.org/u/Eben60)\
**Post date:** [December 6, 2025, 1:19pm UTC](https://discourse.julialang.org/t/algebraofgraphics-documentation-frustrations/133903/45 "2025-12-06T13:19:28Z")

</div>

Actually I do find AoG a reasonable choice for “the rest of us”, too. Herewith I mean, there is what I would call

- “ **observational sciences** ”, which typically involves a lot of statistics,
- **modelling** , and
- “ **experimental sciences and hands-on engineering** ” - this is the “rest of us” here.

The last group is underrepresented among the Julia users (because the first two are overrepresented), but it it would be nice if you, the majority, be kind to us, the minority, 😛 , and keep our needs and perspectives in mind, too.

And in this my perspective, as I [wrote here above](https://discourse.julialang.org/t/algebraofgraphics-documentation-frustrations/133903/32), one generally needs just three plot types, and preferably an easy way to produce them. AoG mostly can do it (sure, even just with `Scatter` / `Line` / `BarPlot` there would be a lot of special requests for special cases not covered directly by AoG).

The problems are IMO - first, documentation. There are a few post above saying “I struggled”, “plotting is generally difficult” etc. Actually I _do not think_ AoG concepts are intrinsically difficult (I found them quite logical after all), and I _do not think_ making a simple plot must necessarily be difficult. Therefore my suggestion is to add [something like this](https://github.com/Eben60/AoG_DocsDraft.jl/blob/main/docs/src/intro.md) TLDR chapter to the manual. @jules what is your opinion on this?

And second - dual axes, which is “our” very common need. IMO, it would be highly beneficial to have native support for dual axes in AoG, but if not, there are [workarounds](https://discourse.julialang.org/t/2-y-axes-in-algebra-of-graphics/68968/5).

---

_[View the full topic](https://discourse.julialang.org/t/algebraofgraphics-documentation-frustrations/133903)._