You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I believe the idea is to merge any changes from your_branch into the latest on the initial work. Then it looks like there's some automation to put those changes and any others desired into the develop branch. Then, when we are ready we push the develop branch changes to the gh_pages branch to publish.
I stress that I'm not sure this is the current flow but that's my impression from GitLens.
Maybe we could update the README.md to include some of this and describe the workflow to save time for people in the future and make outside contributing more simple
The text was updated successfully, but these errors were encountered:
Oglopf
changed the title
Document the branching strateg for docs
Document the branching strategy for docs
Dec 11, 2023
Spoke in our stand-up and it looks like we are using latest to have the current branch which is used for the docs which gh-pages then uses to generate docs.
The develop branch will be used for docs that are not published, but are being worked but will be pulled into latest at some future date.
So the flow actually should be this for a new piece of docs:
Yea give or take. Of course the -> are actually different mechanisms. For example -> gh-pages isn't a user action - it just happens as a part of our automation.
While we'll accept changes into develop the step develop -> latest may not happen for some time and may be misleading if it's put together in one single flow like that.
The develop branch will be used for docs that are not published,
All these branches (latest, develop and release_*) are always published once they're updated. You can see develop here - https://osc.github.io/ood-documentation/develop/ that just got updated this morning.
Right now I perceive the flow to look like this:
I believe the idea is to merge any changes from
your_branch
into thelatest
on the initial work. Then it looks like there's some automation to put those changes and any others desired into thedevelop
branch. Then, when we are ready we push thedevelop
branch changes to thegh_pages
branch to publish.I stress that I'm not sure this is the current flow but that's my impression from GitLens.
Maybe we could update the
README.md
to include some of this and describe the workflow to save time for people in the future and make outside contributing more simpleThe text was updated successfully, but these errors were encountered: