Advanced Settings

Prev Next

Advanced Settings

The Advanced Settings page provides fine-grained control over repository behavior, access rules, collaboration features, and integration options. These settings let you tailor how your repository is used, documented, reviewed, and managed across your organization.


Files

Controls access to the repository’s source code, commits, and branches.

Why this matters:
Restricting file visibility allows organizations to provide limited access to collaborators, external partners, or automated systems while protecting sensitive project data.


Wiki

Each repository can use either the built-in Wiki or link to an external documentation portal.

Why this matters:
Documentation needs vary—some teams use lightweight in-repo documentation, while others publish docs on external platforms (Document360, GitHub Pages, Confluence, etc.).

Enable Repository Wiki

Toggle the Wiki feature on or off. Disabling the Wiki hides the tab entirely.

Built-in Wiki Options

  • Default Wiki Branch Name – The branch used to store Wiki pages (default: master).
  • Default Access Permission – Controls which signed-in users can read or edit the Wiki.

External Wiki

Redirects the Wiki tab to an outside documentation site.

  • External Wiki URL – Destination for all Wiki navigation.

Issues

Configure how issue tracking works within the repository.

Why this matters:
Issue tracking is central to planning and execution. Whether you use AllSpice’s built-in system or connect to an external tracker, these options control how work is reported, tracked, and automated.

Enable Repository Issue Tracker

Turns the built-in issue tracker on or off.

Built-in Issue Tracker Options

  • Enable Time Tracking – Allow users to log estimated or actual time.
  • Let Only Contributors Track Time – Restricts time logging to contributors.
  • Enable Dependencies for Issues and Design Reviews – Allows linking issues to define sequencing or blockers.
  • Close an Issue via e-commit Made in a Non-default Branch – Allows commit messages in any branch to close issues (e.g., Fixes #123).

Use External Issue Tracker

Redirects all issue navigation to a third-party system (GitHub Issues, Jira, YouTrack, etc.).

External Issue Tracker Settings

  • External Issue Tracker URL
  • External Issue Tracker URL Format

Example format:
https://hub.allspice.io/{user}/{repo}/issues/{index}

Where:

  • {user} — username
  • {repo} — repository name
  • {index} — issue number extracted from commits or URLs

Issue Number Extraction

Defines how the system identifies issue numbers:

  • Numeric (#123)
  • Alphanumeric (ABC-123)
  • Regular Expression – Uses the first capture group as {index}.

Why this matters:
Different teams use different issue formats. Proper extraction ensures commits automatically link to the correct external issues.


Projects

Enable Projects

Turns on the Projects tab for planning, boards, milestones, or workflow management.

Projects Mode

Determines which types of projects are available or visible.

Why this matters:
Projects help organize work visually. Enabling or restricting project types ensures consistency with team workflows.


Releases

Enable Repository Releases

Enables the Releases tab for distributing compiled binaries, firmware, hardware files, or packaged assets.

Why this matters:
Releases provide a structured location for versioned build outputs, improving traceability and downstream consumption.


Packages

Enable Repository Package Registry

Allows the repository to host and publish packages (such as libraries, components, or build artifacts).

Why this matters:
Package registries simplify distribution and reuse of components across multiple projects.


Actions

Enable Repository Actions

Activates automated workflows such as CI/CD pipelines, testing, validation, and deployment scripts.

Why this matters:
Actions let you automate repetitive or critical tasks, improving reliability and reducing human error.

See Actions documentation


Design Reviews

Enable Repository Design Reviews

Turns on structured review workflows for hardware or software designs.

Why this matters:
Design Reviews provide formal review and sign-off mechanisms, essential for engineering teams that follow traceable development processes.

See Design Reviews


Merge Styles

Control how pull requests are merged into the repository.

Why this matters:
Different teams follow different merge philosophies. These settings let you enforce clean history, traceability, or fast-forward-only workflows depending on your development model.

Allowed Merge Methods

  • Merge Commit – Creates a merge commit preserving full history.
  • Rebase (fast-forward) – Rewrites commits on top of the target branch.
  • Rebase then Fast-Forward
  • Rebase then Create Merge Commit
  • Disable Squash Commit – Prevents squashing PRs into a single commit.
  • Fast-Forward Only – No merge commits allowed; requires linear history.
  • Manually Merged – Detects merges done outside the UI.

Default Merge Style

Specifies the default merge action shown when completing pull requests.

Additional Merge Options

  • Allow edits from maintainers by default
  • Enable updating design review branches by rebase
  • Delete design review branches after merge
  • Auto-detect manual merges
  • Ignore whitespace for conflict resolution