Re: [doc] How to do simple things? Missing

From: Miral Shah (miralshah2211_at_[hidden])
Date: 2019-06-10 11:21:14

I completely agree here with you. I started my journey with Boost.GIL by
reading this question. Although GIL is well documented, one more thing we
can do is add complete code snippets which can be copied and run directly.
I have struggled with this problem because every time when I had to run
something from documentation I first had to find the corresponding headers,
or we can specify which headers are supposed to be included and we can let
driver code written by the user.

On Sat, Jun 8, 2019 at 1:12 AM Mateusz Loskot <mateusz_at_[hidden]> wrote:

> Hi,
>
> Today I stumbled upon an interesting comment to a GIL related quetsion on
> StackOverflow [1]:
>
> "Create an image of, say 512x512. Fill it with red pixels. Write to PNG. I
> can't
> find anything about doing any of that, at all, in the documentation for
> gil."
>
> and
>
> "I had this same problem (...) the tutorial material shows you a ton of
> clever
> stuff with the view types...but then you come to try it yourself and
> realize
> you've still been given no idea how to actually create an concrete image
> for
> a view to refer to!"
>
> I think these are very important hints to us on how to make the
> documentation
> better. We need to consider growing the tutorials section, writing it as a
> cookbook of basic and short recipies.
>
>
> And, despite the lacking documentation the person is willing to share some
> good
> opinion: "stick with it [GIL], it really is an incredibly elegant library
> for dealing with images". This should be encouraging, innit? :D
>
> [1]
> https://stackoverflow.com/questions/5889235/creating-image-with-boost-gil#comment6776063_5889235
>
> Best regards,
> --
> Mateusz Loskot, http://mateusz.loskot.net
> Fingerprint=C081 EA1B 4AFB 7C19 38BA  9C88 928D 7C2A BB2A C1F2
> --
> Boost-gil mailing list
> Boost-gil_at_[hidden]
> https://lists.boost.org/mailman/listinfo.cgi/boost-gil
>

-- 
Thank you,
Miral Shah