Adds a bit about redoc logo in docs, adds a custom_path_ordering hook, adds ability for configuring hooks from config

[allen-munsch]

Adds a bit about redoc logo in docs, adds a custom_path_ordering hook, adds ability for configuring hooks from config

[codecov]

Codecov Report

Merging #410 (c238aef) into master (2684fda) will decrease coverage by 0.28%.
The diff coverage is 36.00%.

@@            Coverage Diff             @@
##           master     #410      +/-   ##
==========================================
- Coverage   98.51%   98.22%   -0.29%     
==========================================
  Files          55       55              
  Lines        5394     5416      +22     
==========================================
+ Hits         5314     5320       +6     
- Misses         80       96      +16     

Impacted Files	Coverage Δ
drf_spectacular/settings.py	100.00% <ø> (ø)
drf_spectacular/hooks.py	84.76% <11.11%> (-15.24%)	⬇️
drf_spectacular/generators.py	97.93% <100.00%> (+0.07%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 2684fda...c238aef. Read the comment docs.

[tfranzel]

Hi @allen-munsch, thanks for the PR. i think i need a bit more context. please correct me if i'm wrong but i believe we already have this functionality with PREPROCESSING_HOOKS. see comments below.

furthermore it would break everyone using POSTPROCESSING_HOOKS. we really need a very good reason to even consider breaking compatibility.

[tfranzel]

I can see the need for custom endpoint order.

to me that looks like a perfect usage of PREPROCESSING_HOOKS: https://drf-spectacular.readthedocs.io/en/latest/customization.html#step-7-preprocessing-hooks

there you can filter and reorder the endpoints to your liking. Not sure if this adds anything substantial to that existing functionality?

[allen-munsch]

@tfranzel yeah i dunno preproccess hook didn't seems to keep the ordering

also the core hooks are not configurable, sure can keep configs bundled with the hooks, but i dunno settings allover the place instead of all in the settings.py seems werid.

and i didnt see offhand how restframework APISettings would allow that alongside the dot imports strings

[tfranzel]

@tfranzel yeah i dunno preproccess hook didn't seems to keep the ordering

that is an excellent point. i noticed there is sorting applied after the PREPROCESSING_HOOK. we should make that final sorting optional via settings. the sorter was once configurable but was superceded by the hooks. would that work for you?

also the core hooks are not configurable, sure can keep configs bundled with the hooks, but i dunno settings allover the place instead of all in the settings.py seems werid.

there should be nothing preventing you from loading the django/DRF settings inside the hook and then using them. then you have everything in your settings.py. am i missing something?

[tfranzel]

come to think of it. we have SORT_OPERATION_PARAMETERS with True/False/callable. would seem logical to do the same here. then you could choose between doing it in a hook or writing a sorting callable yourself.