Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Determine the FORD version number for FORD CI document deployment #673

Closed
zoziha opened this issue Aug 12, 2022 · 3 comments · Fixed by #681
Closed

Determine the FORD version number for FORD CI document deployment #673

zoziha opened this issue Aug 12, 2022 · 3 comments · Fixed by #681
Labels
documentation Improvements or additions to documentation idea Proposition of an idea and opening an issue to discuss it

Comments

@zoziha
Copy link
Contributor

zoziha commented Aug 12, 2022

Motivation

As far as I know, in both #624 and #278, the failure of FORD document deployment occurs, which is often caused by the features and version updates of FORD.
Determining the appropriate FORD version for stdlib in stages will help new contributors are less likely to face FORD CI failures due to FORD version updates.

Prior Art

brew install -f --force-bottle --keep-tmp ford

We can use:

pip install -v ford==6.1.10

Additional Information

@zoziha zoziha added documentation Improvements or additions to documentation idea Proposition of an idea and opening an issue to discuss it labels Aug 12, 2022
@awvwgk
Copy link
Member

awvwgk commented Aug 13, 2022

There is some historical baggage on the documentation workflow, see #289. It might be time to revisit the workflow and use a different setup strategy.

@zoziha
Copy link
Contributor Author

zoziha commented Sep 24, 2022

Currently stdlib publishes FORD documents based on macOS and brew, while fpm publishes FORD documents based on Ubuntu and pip, it seems to use pip to install ford and publish docs is easier, maybe we can update stdlib's docs CI with fpm's CI.

@jvdp1
Copy link
Member

jvdp1 commented Sep 24, 2022

I think it makes sense to use the same strategy in all Fortran-lang projects regarding ford.
@zoziha would you like to open a PR with a new strategy?

@zoziha zoziha mentioned this issue Sep 25, 2022
3 tasks
14NGiestas added a commit that referenced this issue Sep 25, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation idea Proposition of an idea and opening an issue to discuss it
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants