Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Stdlib documentation #599

awvwgk started this conversation in General
Dec 14, 2021 · 2 comments · 3 replies
Discussion options

Now that the new documentation for fpm is up at https://fpm.fortran-lang.org/, what do you think about adopting a similar framework for stdlib as well?

You must be logged in to vote

Replies: 2 comments 3 replies

Comment options

Unfortunately I missed the last Fortran meeting. Generally speaking, the look and feel of the fpm documentation is better than the current FORD output. I'd be in favor of adopting a similar framework.

Speaking of documentation, the new matplotlib documentation looks excellent: https://matplotlib.org/

You must be logged in to vote
3 replies
Comment options

awvwgk Jan 19, 2022
Maintainer Author

Nice, this looks like based on pydata-sphinx-theme, but heavily modded with CSS (actually exactly the kind of modifications I'd need for the fortran-lang.org webpage, definitely going to steal this one).

Comment options

awvwgk Jan 19, 2022
Maintainer Author

They have actually their own sphinx theme (https://github.com/matplotlib/mpl-sphinx-theme) to customize the pydata one

Comment options

I agree. FWIW, the original fortran-lang.org site was a direct adaptation of https://neovim.io/. We could take the same approach now. I'd be happy to help port much of the content to the new framework if we choose to do so.

Comment options

awvwgk
Jan 29, 2022
Maintainer Author

Scaffold structure for the stdlib-docs are up: https://github.com/awvwgk/stdlib-docs

Nothing has been written yet and the color scheme has been stolen from fpm. Before we can consider this ready to be maintained under fortran-lang namespace we need some content, here are some suggestions:

  • installation instruction in how-to (installing fypp, supported Fortran compilers)
  • tutorials for a selected number of modules (at least two)
  • workflow for contributing under design
  • news announcement for v0.1.0
You must be logged in to vote
0 replies
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet

AltStyle によって変換されたページ (->オリジナル) /