1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
git-ubuntu
==========
.. A single sentence that says what the product is, succinctly and memorably
git-ubuntu is tooling that provides unified git-based workflows for the
development of Ubuntu source packages.
.. A paragraph of one to three short sentences, that describe what the product
does.
The git-ubuntu importer service maintains a view of the entire packaging
version history of Ubuntu source packages using git repositories with a common
branching and tagging scheme. The git-ubuntu CLI provides tooling and
automation that understands these repositories to make the development of
Ubuntu itself easier.
.. A third paragraph of similar length, this time explaining what need the
product meets.
Since Ubuntu's packaging architecture pre-dates git, different packages have
evolved to use different mechanisms to achieve the same thing. Developers had
to learn them all in order to be effective when working across a wide range of
packages. git-ubuntu's unification of these mechanisms allows for simpler, more
general tooling, which results in faster onboarding of new developers and
easier "drive-by" contributions.
.. Finally, a paragraph that describes whom the product is useful for.
git-ubuntu is useful for those inspecting, working on, or looking to contribute
to Ubuntu source packages themselves.
----
In this documentation
---------------------
.. grid:: 1 1 2 2
.. grid-item::
.. grid-item:: :doc:`How-to guides <howto/index>`
**Step-by-step guides** covering key operations and common tasks
.. grid:: 1 1 2 2
:reverse:
.. grid-item:: :doc:`Reference <reference/index>`
**Technical information** - specifications, APIs, architecture
.. grid-item:: :doc:`Explanation <explanation/index>`
**Discussion and clarification** of key topics
----
Project and community
---------------------
git-ubuntu is a member of the Ubuntu family. It’s an open source project that
warmly welcomes community projects, contributions, suggestions, fixes and
constructive feedback.
* `Code of conduct <https://ubuntu.com/community/code-of-conduct>`_
* `Join our online chat <https://web.libera.chat/#ubuntu-devel>`_
* `View the source <https://git.launchpad.net/git-ubuntu>`_
* `Report bugs <https://bugs.launchpad.net/git-ubuntu/+filebug>`_
.. toctree::
:maxdepth: 2
:caption: Contents:
explanation/index
howto/index
reference/index
|
