Reorganized docs structure

[tomchor]

This is an attempt to make the left menu of the docs feel a bit more intuitive and organized. What I did:

• Moved benchmarks, function index and library to appendix. I think not many people need that information, so it makes sense put it there I think)
• Moved appendix to be the last item on the menu (as is customary for most documents)
• Moved gallery to after the contributor's guide (since I think contributor's guide is more important so it can come first)

I know this is unprompted (nobody complained about the docs) but I think it's a positive change. Eager to hear opinions.

[glwagner]

Those changes seem positive to me! I can't find the preview though, any idea where that might be?

[tomchor]

No idea! According to @navidcy it should be at https://clima.github.io/OceananigansDocumentation/previews/PR1838, but it says page not found.

[tomchor]

Also here's a more proper source for that: JuliaDocs/Documenter.jl#1131 (comment)

So idk what's wrong here. @navidcy any idea?

[navidcy]

Also here's a more proper source for that: JuliaDocs/Documenter.jl#1131 (comment)

So idk what's wrong here. @navidcy any idea?

Strange...
From looking at the log, it seems it didn't push the preview...
https://buildkite.com/clima/oceananigans/builds/3216#7afaa702-7973-4f52-8d71-73e07874666d

Let me look into it bit more :)

[navidcy]

Approve 👍🏼; just good to see the preview that all renders OK before merging.

[navidcy]

Now we have a preview: https://clima.github.io/OceananigansDocumentation/previews/PR1838/

(I don't know why... I didn't really do anything...)

[navidcy]

Looks good to me

[francispoulin]

I'm happy with these changes too. Francis

…

________________________________ From: Navid C. Constantinou ***@***.***> Sent: Thursday, July 8, 2021 10:37:30 PM To: CliMA/Oceananigans.jl ***@***.***> Cc: Subscribed ***@***.***> Subject: Re: [CliMA/Oceananigans.jl] Reorganized docs structure (#1838) Looks good to me — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub<#1838 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AB63PQKXKILDRISGJGSHYQLTWZOGVANCNFSM5ABR3ZGA>.

[tomchor]

Now we have a preview: https://clima.github.io/OceananigansDocumentation/previews/PR1838/

(I don't know why... I didn't really do anything...)

Weird... Documenter.jl works in mysterious ways