Commit bfed5927 authored by Andreas Tille's avatar Andreas Tille
Browse files

First round to replace Alioth by Salsa - needs to be continued!

parent c578c35a

policy.xml

+11 −45
Original line number Diff line number Diff line
@@ -43,7 +43,7 @@ 
	</mediaobject>

	<sect1 id="introduction">

		<title>Introduction</title>

		<para>Debian Med is a <quote><ulink url="https://blends.alioth.debian.org/blends">Debian Pure Blend</ulink></quote>

		<para>Debian Med is a <quote><ulink url="https://blends.debian.org/blends">Debian Pure Blend</ulink></quote>

		with the aim to develop Debian into an operating system that is particularly

		well tailored for the requirements for medical practice and research.</para>

		<para>The Debian Med project presents packages that are associated
@@ -84,11 +84,11 @@ 
		<sect2 id="membership">

			<title>Membership</title>

			<para>To request membership to this group, please go on our

			<ulink url="https://alioth.debian.org/projects/debian-med">Alioth page</ulink>,

			or directly follow this <ulink url="https://alioth.debian.org/project/request.php?group_id=30063">link</ulink>.

			Remember that you must have an Alioth account before requesting

			membership (see <ulink url="https://alioth.debian.org/account/register.php">here</ulink>

			to request an Alioth account).</para>

			<ulink url="https://salsa.debian.org/med-team/">page on Salsa</ulink>,

			or directly follow this <ulink url="https://salsa.debian.org/groups/med-team/-/group_members/request_access">link</ulink>.

			Remember that you must have an account on Salsa.debian.org before requesting

			membership (see <ulink url="https://salsa.debian.org/users/sign_in">here</ulink>

			to request an account on Salsa.debian.org).</para>

		</sect2>

		<sect2 id="readings">

			<title>Essential readings</title>
@@ -116,14 +116,8 @@ 
	<sect1 id="repositories">

		<title>Repositories</title>

		<para>We use Git repositories, hosted 

		by Debian. You can have a look at

		each repository through Alioth's web interfaces: 

		<ulink url="https://anonscm.debian.org/cgit/debian-med">cgit</ulink>.</para>

		<warning id="umask">

			<para>

				For most direct operations on the repositories in Alioth, an <command>umask</command> of <literal>002</literal> is necessary to avoid problems of missing write permission to the other team members.

			</para>

		</warning>

		by Debian. You can have a look at each repository through 

		<ulink url="https://salsa.debian.org/groups/med-team/">Salsa's web interfaces</ulink>.</para>

		<sect2 id="source">

			<title>Give me the source!</title>

			<para>
@@ -144,8 +138,8 @@ 
<command>debcheckout</command> <option>--user</option> <replaceable>&lt;username&gt;</replaceable> <option>--git-track <replaceable>'*'</replaceable></option> <replaceable>&lt;package&gt;</replaceable></programlisting>

						</para>

						<para>

							For draft packages that are only on Alioth:<programlisting>

<command>debcheckout</command> <option>--user</option> <replaceable>&lt;username&gt;</replaceable> <replaceable>git://git.debian.org/debian-med/&lt;package&gt;.git</replaceable> <option>--git-track <replaceable>'*'</replaceable></option></programlisting> 

							For draft packages that are only on Salsa:<programlisting>

<command>gbp</command> <option>clone</option> <replaceable>&lt;username&gt;</replaceable> <replaceable>git@salsa.debian.org:med-team/&lt;package&gt;.git</replaceable></programlisting> 

						</para>

						<para>

						  For packages managed with Git, the option <option>--git-track</option>
@@ -167,40 +161,12 @@ 
				</itemizedlist>

			</para>

		</sect2>

		<sect2 id="ssh-tips">

			<title>SSH tips</title>

			<para id="ssh-config">

				You can avoid specifying your Alioth user name by setting it in

				<filename>~/.ssh/config</filename> as follows.  Note that in that case,

				with <command>debcheckout</command> you will can replace the

				<option>--user</option> option by the <option>-a</option> option, for a

				shorter typing.<programlisting>

Host *.debian.org

	User your-user-name</programlisting>

			</para>

			<para id="ssh-add">

				You can avoid typing your SSH password again and again using the

				<code><command>ssh-add</command></code> command.  On remote connections

				the SSH agent needs to be enabled with the command

				<code><command>eval</command>

				<option>$(</option><command>ssh-agent</command><option>)</option></code>.

			</para>

			<para id="wiki-alioth">

				In case of trouble getting SSH working it is a good idea to read

				<ulink url="https://wiki.debian.org/Alioth/SSH">this wiki article</ulink>.

			</para>

		</sect2>

		<sect2 id="git-repository-structures">

			<title>Common Git repository structures</title>

			<para>

				The area on Alioth that contains the Git repositories (<filename

				class="directory">/git/debian-med</filename>) is not itself structured,

				but the repositories can be arranged in different possible layouts.

			</para>

			<sect3 id="git-buildpackage">

				<title><command>gbp buildpackage</command></title>

				<para>

					Most of our packages using Git and stored in Alioth are managed following

					Most of our packages using Git and stored on Salsa are managed following

					the standard layout of the <command>gbp buildpackage</command> helper.  The

					<literal>master</literal> branch contains the full source package. 

					The <literal>upstream</literal> branch contains the upstream source,