SciML / SciMLDocs

Global documentation for the Julia SciML Scientific Machine Learning Organization
https://docs.sciml.ai
MIT License
53 stars 39 forks source link

Standardize all repositories to the new and improved setup #24

Closed ChrisRackauckas closed 1 year ago

ChrisRackauckas commented 2 years ago

This includes:

Anything missed?

isaacsas commented 2 years ago

I don't know if having the download count is really needed or even wanted for all packages. Particularly for newer repos it will be quite low so not so great as an advertisement to use the package.

Is there any reason you are dropping Coveralls from the badges? I usually find its coverage reports much more useful to go through interactively than codecov.

ChrisRackauckas commented 2 years ago

I think codecov is the only one that properly pools all of the statistics, so Coveralls will drop downstream, documentation, and buildkite coverage files.

YichengDWu commented 2 years ago

It seems like the current formatting CI will not format markdown files. Maybe we should add format_md? I could be wrong tho.

YichengDWu commented 2 years ago

changing format(".", verbose=true) to format(".", verbose=true, format_markdown=true) would be good

ChrisRackauckas commented 2 years ago

format_markdown seems to cause some errors 😅 so I'm skipping over that for now. I think a good 80% here is just to format all repos and give it the new docs setup, so I'll try to do that today, and then over the next month be going around to example formatter and fix JuliaFormtter.jl issues.

@YingboMa did you run into the format_markdown errors?

ChrisRackauckas commented 2 years ago

Alright, the massive reorganization is starting to see the light at the end of the tunnel.

DiffEqJump -> JumpProcesses still needs to be done.

The formatter hit a lot of errors which were captured here: https://github.com/domluna/JuliaFormatter.jl/issues/610, so those repos will not have the formatter on them at least for now until that gets cleaned up.

Someone needs to go update the badges on all repos, 😅 that'll be fun.

Documentation coverage statistics increases the build times by more than 3x, which is not possible in some repos (like DiffEqSensitivity), but we should enable it where we can.

Strict mode for documenter is still necessary in a few repos, and that can happen in a case-by-case basis. NeuralPDE.jl is the next big one I'll be doing (and that may need to split parallelize those tests onto multiple CI to get below 3 hours), and then the DiffEqDocs. But there's a lot of other smaller ones that can probably be done in an hour or so (RecursiveArrayTools, LinearSolve, NonlinearSolve, Integrals, ...)

ArnoStrouwen commented 1 year ago

Most of the packages in the numerical utilities group just point toward a readme, because they don't have docs. I think this should be standardized also.

ArnoStrouwen commented 1 year ago

I badged and doc covered most of the repos.

ChrisRackauckas commented 1 year ago

I think the rest of the @exampleing can be done on a repo-by-repo basis. I think it's just MTK and DiffEqDocs now.

Thanks all!