From 681af0aeaa2ebb566eb98c9037256f9c1eee7f10 Mon Sep 17 00:00:00 2001 From: Michael Abbott <32575566+mcabbott@users.noreply.github.com> Date: Wed, 19 Oct 2022 19:01:53 -0400 Subject: [PATCH] doc fixup --- docs/src/assets/flux.css | 2 -- docs/src/assets/logo.png | Bin 0 -> 85634 bytes docs/src/index.md | 19 +++++++++---------- 3 files changed, 9 insertions(+), 12 deletions(-) create mode 100644 docs/src/assets/logo.png diff --git a/docs/src/assets/flux.css b/docs/src/assets/flux.css index 541ead5..c3817e7 100644 --- a/docs/src/assets/flux.css +++ b/docs/src/assets/flux.css @@ -100,8 +100,6 @@ article pre { max-width: none; padding: 1em; border-radius: 10px 0px 0px 10px; - margin-left: -1em; - margin-right: -2em; } .hljs-comment { diff --git a/docs/src/assets/logo.png b/docs/src/assets/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..e0a825a5a10569a6b58faa63a9b3753bbd4617ed GIT binary patch literal 85634 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

>|@tqN<3W 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

g7Edv1GTTJq;jDNGDjD)I+E(WZqRi?FC5D92O? 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ȒJyU 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 z%0AG4@!Nq1RsjHq;~AOGGTpkO0?R=_zQ5hiC)bZ3JN7T-XqRZc#M%C%pMQRg333RZ zWzz_3Gu3&oIr>-K;>dJZgaf+*YZ_#aG4C#ctz+WZ?eNCvoZgNHP2RWOetVsK{dND5 z=icpim$dx6FJ-PC6YgZc3(|T7h1vyiU@a7XqZC?W3!Dgl@Tgl~?&jw7^ZafZe;!}_ zl>IpKdEveznod8hpP!w*{oTIb?`}^ozB~(7?g1-uNuU|2(+)Yn9QBi9P5l0SmGAd{ zU)Oc5>fpz0WtV*h^QX0MpUTl~FPivq>Y+yu_p+UVjqn)g088V<$jr~s{zO}tLf*9R zdpLUad!K7ppKpjT+#<2u?&I9TQ@0oK9Q9pZx5^l16VUtffUAB!TszYNi_OhK6%V=N zD=r>6a)kfLx|{F&+xF=@J>hHIh$zW>M3 zyY4k7k$OAMioo7ZSE`vOtkhb`Ij8uXWx89zufKu{@iOxI9sSRb9{>F4aZ_;i%1`dw zljG{e&-)+0^Y6#PcDbqrpOnoU5c!T3SUPbZxoQGUCBVKDaG>U4Byf1`xv5m|XREpA ze(n{pe0HPS&YtP|#8v0bkL^}IR*`S>U-4LVc+H>q!1)#aSC8k`z%vQUDNs{Gb*((q z4u@XWYilAeS3T-f-9N(CMV7Eaip}G}QT@7)k8Uj8V=(V? z^7K!8IEtUU@37W)y4NiK`0K>^=E+&YA7%QVH>TTtigTe~DWM4f DkMI1{ literal 0 HcmV?d00001 diff --git a/docs/src/index.md b/docs/src/index.md index 1a584b6..276b3c7 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -2,19 +2,10 @@ Functors.jl provides a set of tools to represent [functors](https://en.wikipedia.org/wiki/Functor_(functional_programming)). Functors are a powerful means to apply functions to generic objects without changing their structure. -Functors can be used in a variety of ways. One is to traverse a complicated or nested structure as a tree and apply a function `f` to every field it encounters along the way. +The most straightforward use is to traverse a complicated nested structure as a tree, and apply a function `f` to every field it encounters along the way. For large models it can be cumbersome or inefficient to work with parameters as one big, flat vector, and structs help manage complexity; but it may be desirable to easily operate over all parameters at once, e.g. for changing precision or applying an optimiser update step. -## Appropriate Use - -!!! warning "Not everything should be a functor!" - Due to its generic nature it is very attractive to mark several structures as [`@functor`](@ref) when it may not be quite safe to do so. - -Typically, since any function `f` is applied to the leaves of the tree, but it is possible for some functions to require dispatching on the specific type of the fields causing some methods to be missed entirely. - -Examples of this include element types of arrays which typically have their own mathematical operations defined. Adding a [`@functor`](@ref) to such a type would end up missing methods such as `+(::MyElementType, ::MyElementType)`. Think `RGB` from Colors.jl. - ## Basic Usage and Implementation When one marks a structure as [`@functor`](@ref) it means that Functors.jl is allowed to look into the fields of the instances of the struct and modify them. This is achieved through [`Functors.fmap`](@ref). @@ -61,3 +52,11 @@ Baz(1.0, 2) Any field not in the list will be passed through as-is during reconstruction. This is done by invoking the default constructor, so structs that define custom inner constructors are expected to provide one that acts like the default. +## Appropriate Use + +!!! warning "Not everything should be a functor!" + Due to its generic nature it is very attractive to mark several structures as [`@functor`](@ref) when it may not be quite safe to do so. + +Typically, since any function `f` is applied to the leaves of the tree, but it is possible for some functions to require dispatching on the specific type of the fields causing some methods to be missed entirely. + +Examples of this include element types of arrays which typically have their own mathematical operations defined. Adding a [`@functor`](@ref) to such a type would end up missing methods such as `+(::MyElementType, ::MyElementType)`. Think `RGB` from Colors.jl.