You are here: start » en » Internal Documentation » Working with projects

Working with projects

This area leads from discovering a project to submitting a change. It assumes no knowledge of namespaces, permission files or the connected source control system.

Which projects and repositories can I see? One page answers both: Projects and repositories (German). It names the number of projects and repositories visible to your account and carries both lists below, with search and filters.

Getting started

Quickstart: from project to source — the shortest way to a first result, in three steps, without Git.

Find a projectFind a repositoryBrowse sourcecloneSubmit a change

Common tasks

Structure

<html>

<div style="display:grid;grid-template-columns:repeat(4,minmax(130px,1fr));min-width:560px">
  <div style="border-right:1px solid var(--wk-border-light, #e3e6ec);padding:10px 12px">
    <div style="font:600 12px/1.4 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-ink, #3b4252)">1 Entry</div>
    <div style="font:11px/1.5 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-text, #5b6472)">both counts, both lists</div>
  </div>
  <div style="border-right:1px solid var(--wk-border-light, #e3e6ec);padding:10px 12px">
    <div style="font:600 12px/1.4 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-ink, #3b4252)">2 Repositories</div>
    <div style="font:11px/1.5 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-text, #5b6472)">cross-project list</div>
  </div>
  <div style="border-right:1px solid var(--wk-border-light, #e3e6ec);padding:10px 12px">
    <div style="font:600 12px/1.4 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-ink, #3b4252)">3 Repository</div>
    <div style="font:11px/1.5 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-text, #5b6472)">code, branches, tags</div>
  </div>
  <div style="padding:10px 12px">
    <div style="font:600 12px/1.4 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-ink, #3b4252)">4 Obtaining</div>
    <div style="font:11px/1.5 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-text, #5b6472)">ZIP, clone, dev environment</div>
  </div>
</div>
<div style="border-top:1px solid var(--wk-border-light, #e3e6ec);padding:10px 12px">
  <div style="font:600 12px/1.4 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-ink, #3b4252)">5 Contributing</div>
  <div style="font:11px/1.5 var(--wk-font-body, system-ui, sans-serif);color:var(--wk-text, #5b6472)">see your role, request access, submit a change</div>
</div>

</html>

Region What happens there
1 The entry point. Names how many projects and repositories this account may see, and carries both lists with search and filters.
2 The repository table across all projects — as part of the entry point, or on its own where only the repository name is known.
3 A repository with file tree and lists of branches and tags.
4 The routes to the source: archive, Git, development environment.
5 The way from “may read” to “may contribute”.

Key features

  • Project overview with search, status filter and your own role per project.
  • Cross-project repository list, filtered by what your own account may see.
  • Source view in the browser with branch and tag selection, without a local installation.
  • Archive download as a ZIP file for everybody who does not use Git.
  • Git access through an endpoint of the wiki, with a personal access token.
  • A structured request for contributor rights instead of an instruction to go and find somebody.

The underlying idea

A project is a working area with a key of its own. A person's role applies to the whole project, not to the single page, and a repository inherits the permission of the namespace it hangs on. There is therefore no second permission system beside the wiki's own.

In full: How a project is built describes the areas, Visibility and permissions what follows for lists and numbers, Contributing the ladder of roles.

Administration

Managing the connections and mounts belongs to the wiki administration; the project pages themselves are written by the people working on the project. Mounting a repository also sets the permissions of its namespace. How a new project is created is in Create a project.

Troubleshooting

For developers

en/wiki/projects/start.txt · Last modified: by 0.0.0.0