From f3d695655ad43181acfb47fd0d6f14f79e85e110 Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Sun, 18 Dec 2016 15:10:17 +0100 Subject: Drop chapters/sections I don't have time to write --- doc/admin/000.mdwn | 63 ++++++++++++++++++++++-------------------------------- 1 file changed, 25 insertions(+), 38 deletions(-) diff --git a/doc/admin/000.mdwn b/doc/admin/000.mdwn index 929d8d5..c46ed52 100644 --- a/doc/admin/000.mdwn +++ b/doc/admin/000.mdwn @@ -98,8 +98,31 @@ soon. # Repository management -FIXME. This chapter discusses repository management, including -repository config variables. +Repositories are managed using commands in the nearby table. Use the +Gitano `help` command to get details. + +------- --------------------------------------------------- +command description +`create` create a new, empty repository +`destroy` destroy a repository +`copy` create a new repoistory by copying an existing one +`config` inspect or set repository configurtion +------- --------------------------------------------------- + +Configuration variables for repositories are listed in a table. + +------- --------------------------------------------------- +variable description +`project.description` description of repo, shown by web interface +`project.head` where the repository HEAD points, e.g., `refs/heads/master` +`project.owner` Gitano user who owns the repository +------- --------------------------------------------------- + +FIXME: Are there more? + +You can set any configuration varible, but the `project.*` ones have +special meaning to Gitano. + # Lace syntax and semantics @@ -280,40 +303,6 @@ follows: FIXME: What about per-project rules? -## Testing one's ruleset - -META: This section discusses systematic testing of one's ruleset. -Might or might not include automated testing (with yarn). - -# The default Gitano ruleset - -META: This chapter is a walkthrough of the default Gitano ruleset. -Ideally implemented in such a way that it is either generated from the -Gitano source code, or vice versa. - -# Good practices for writing rulesets - -META: This chapter discusses various best practices for writing Gitano -rulesets. It may initially have to be a skeleton until the Gitano -community gathers enough experience to write something substantial. -But an interview with Daniel for good ideas should come up with enough -for an initial chapter. - -# Common things one may want to do - -META: This chapter discusses some common changes one may want to do to -the default ruleset. Ideally, there would be none, but reality is ugly. - -## Anonymous access - -META: This section describes how to allow anyone access to specific -repositories. - -## Cgit integration - -META: This section describes how to allow cgit show specific -repositories. - # Backup and restore of a Gitano instance When gitano-setup is run, the admin needs to specify a Unix user in @@ -322,5 +311,3 @@ we'll assume the home directory is `/home/git`. To backup a Gitano instnace, backup `/home/git`. To restore, restore the directory. - -FIXME: Need to re-generate .ssh/authorizes_keys? -- cgit v1.2.1