Update README.md compiler, archiver, & link flags #598
Conversation
There was a problem hiding this comment.
Thank you @rouson, this looks great.
I wonder about the README info being out of sync with the latest release. These env. variables are currently only available from the main branch, but not in 0.4.0. A user downloading the latest release binary could be confused why these env variables from the README don't work.
I don't know if we have had a discussion or workflow for this situation. Some ideas on how to work around this:
mainis always == latest release and all development features go into a release candiate branch (e.g.rc-0.5.0). or- New release on every new feature merge.
There was a problem hiding this comment.
Thanks Damian @rouson - looks good to me 👍
Yes, I think that issue has cropped up before @milancurcic . My preferred solution would be for development on a separate dev branch or release candidate as you suggest.
|
I don't think we need a separate branch for development (yet). I prefer to have the repository default branch represent the latest development state of a project. Currently the main branch is always in a state that it can be released, we can do this continuously without tagging releases as well (see #569). I think the main issue is that we don't have a dedicated user documentation for the fpm yet (the docs at https://fpm.fortran-lang.org are targeted at developers). Preferably we can setup documentation with tutorials and how-to guides which always provide the last stable and the latest version of the user documentation. |
|
One way to mitigate the problem @milancurcic identified is to release more often. In agile sprints, releases happen every 2-3 weeks. If the main branch is always releasable, there's little downside other than the labor involved, which can be lessened by automated any labor-intensive aspects of releasing. |
|
With two reviews I'll now merge this PR. Thanks everyone. |
This PR completes and updates the README.md description of the above
fpmflags to match the description given byfpm build --help.