#git-workflows — Public Fediverse posts
Live and recent posts from across the Fediverse tagged #git-workflows, aggregated by home.social.
-
Neuer Artikel im Blog:
Git für TYPO3: Endlich entspannt an Projekten arbeiten
https://wwagner.net/blog/a/git-fuer-typo3-endlich-entspannt-an-projekten-arbeiten
-
Neuer Artikel im Blog:
Git für TYPO3: Endlich entspannt an Projekten arbeiten
https://wwagner.net/blog/a/git-fuer-typo3-endlich-entspannt-an-projekten-arbeiten
-
#TechnicalWriting #DocsAsCode #Markdown #Git #SoftwareDocumentation #GitWorkflows #SoftwareDevelopment: "When you use a docs as code workflow, you need to codify your docs processes and instantiate them in your Git workflow. So you not only need to define the following:
- When to publish doc updates
- How to release doc updates
- How to coordinate a docs release with a product releaseYou also need to define Git best practices for your team about how to manage those, such as:
- Whether to use release branches, or merge pull requests frequently but publishing infrequently.
- Whether to use Git rebase or Git merge to maintain Git history in a given branch.
- Whether and how to use feature branches and pull requests.
- Whether to squash merge pull requests to main.Even if you manage to define best practices that your team is committed to following, there isn’t a way to force your documentation contributors to adhere to all of these best practices. Due to the lack of enforcement of these best practices, you can easily end up in a situation where writers follow slightly different practices based on what their tools make easy to do."
https://thisisimportant.net/posts/docs-as-code-broken-promise/
-
#TechnicalWriting #DocsAsCode #Markdown #Git #SoftwareDocumentation #GitWorkflows #SoftwareDevelopment: "When you use a docs as code workflow, you need to codify your docs processes and instantiate them in your Git workflow. So you not only need to define the following:
- When to publish doc updates
- How to release doc updates
- How to coordinate a docs release with a product releaseYou also need to define Git best practices for your team about how to manage those, such as:
- Whether to use release branches, or merge pull requests frequently but publishing infrequently.
- Whether to use Git rebase or Git merge to maintain Git history in a given branch.
- Whether and how to use feature branches and pull requests.
- Whether to squash merge pull requests to main.Even if you manage to define best practices that your team is committed to following, there isn’t a way to force your documentation contributors to adhere to all of these best practices. Due to the lack of enforcement of these best practices, you can easily end up in a situation where writers follow slightly different practices based on what their tools make easy to do."
https://thisisimportant.net/posts/docs-as-code-broken-promise/