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

Enhanced developer documentation #3013

Merged
merged 7 commits into from
Sep 2, 2022
Merged

Enhanced developer documentation #3013

merged 7 commits into from
Sep 2, 2022

Conversation

jedevc
Copy link
Member

@jedevc jedevc commented Aug 9, 2022

This PR attempts to rework some of the existing developer documentation, while adding some additional pages.

The driving idea behind this is to have a central location in ./docs/dev where potential buildkit contributors and integrators can read and learn about the internal mechanisms without needing to dive into the code for all of the details. Ideally, we'd work to build this out over time even more, especially around areas that are especially complex, are areas that we expect developers to integrate with, such as attestations, frontends, etc.

@hinshun, @tonistiigi tells me you're the original author of the "Buildkit developer guide" google doc that I've taken the content for the request-lifecycle.md and dockerfile-llb.md pages from (though I've changed some of the examples to be more up-to-date). I'd like to add you as a co-author to those commits, could you confirm if you're happy with that?

@hinshun
Copy link
Collaborator

hinshun commented Aug 9, 2022

@jedevc Happy to be added. It's good to see more efforts being put towards BuildKit documentation. 👍

@coryb also worked on some parts of the document.

@jedevc
Copy link
Member Author

jedevc commented Aug 10, 2022

@coryb could you also confirm you'd be happy to be added as a co-author on the relevant import commits?

@hinshun is there a particular email address you'd like? In the buildkit history I see Edgar Lee <[email protected]>, is that still good?

@hinshun
Copy link
Collaborator

hinshun commented Aug 10, 2022

@jedevc Please use [email protected], I'm no longer at Netflix.

jedevc and others added 7 commits August 16, 2022 12:36
Signed-off-by: Justin Chadwell <[email protected]>
Co-authored-by: Edgar Lee <[email protected]>
Co-authored-by: coryb <[email protected]>
Signed-off-by: Justin Chadwell <[email protected]>
Co-authored-by: Edgar Lee <[email protected]>
Co-authored-by: coryb <[email protected]>
Signed-off-by: Justin Chadwell <[email protected]>
@jedevc
Copy link
Member Author

jedevc commented Aug 16, 2022

Should be ready now:

  • @coryb and @hinshun added as co-authors
  • Comments resolved
  • Diagrams converted to mermaid to easily view in-browser

@jedevc jedevc requested a review from tonistiigi September 1, 2022 14:51
@tonistiigi tonistiigi merged commit 6d9b617 into moby:master Sep 2, 2022
@jedevc jedevc deleted the dev-docs branch September 2, 2022 08:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants