docs icon indicating copy to clipboard operation
docs copied to clipboard

Feature/devops ci

Open memsharded opened this issue 1 year ago • 1 comments

Very initial draft of the first sections, to get team early feedback.

It is better reviewed generating the html docs, not in code.

Depends on https://github.com/conan-io/examples2/pull/153

Close https://github.com/conan-io/docs/issues/3849 Close https://github.com/conan-io/conan/issues/3003 Close https://github.com/conan-io/conan/issues/6589 Close https://github.com/conan-io/conan/issues/6045 Close https://github.com/conan-io/conan/issues/8587 Close https://github.com/conan-io/conan/issues/16309

memsharded avatar Jul 15 '24 10:07 memsharded

Thanks very much for all the feedback!

As this PR is very large and with deep topics I'll suggest the following:

  • Keep this PR reviews exclusively to the contents of the PR itself: if something doesn't work, the examples code in the examples Github repo is not matching the docs, the explanations are unclear, the graphics are poor, typos, grammar, etc., etc.
  • Keep in mind that this section is "didactical", it doesn't aim to be a full and exhaustive implementation of a unique way of implementing CI, but rather to provide some basic concepts, tools and practices, to allow users to implement their own.
  • This is the initial "abstract/core" part of the CI tutorial. Other new sections will follow, hopefully diving deeper and deeper, from explaining different branching/merging/integration strategies, to some implementation examples in a real CI.
  • For other CI related topics and questions that this PR could spark, it would be better to have a dedicated new issue for it, referencing this one, as it is likely that they could result in future PRs adding more info to this current proposal, but it is not planned to augment or increase much more this initial proposal, otherwise it would be intractable.

Many thanks!

memsharded avatar Oct 10 '24 12:10 memsharded