Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
Jonasvdbo authored Feb 20, 2025
1 parent e1aa2d6 commit 05f35ed
Show file tree
Hide file tree
Showing 19 changed files with 17 additions and 17 deletions.
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 1.1.1. Setting up and configuring Archi and the plug-in
# 5.1.1. Setting up and configuring Archi and the plug-in

## Installing Archi

Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 1.1.2. Preparing your GitHub account to configure Archi integration
# 5.1.2. Preparing your GitHub account to configure Archi integration

1. Log onto your GitHub Account at [GitHub.com](https://github.com) or create a GitHub account at [GitHub.com](https://github.com)
2. Please share your GitHub account name by emailing it to [email protected], so that we can add you to the NBility-Model GitHub organization.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 1.1.3. Import the model from GitHub into Archi
# 5.1.3. Import the model from GitHub into Archi

Once you have configured Archi and coArchi, and generated your Github Personal Access Token (PAT) you will be able to import the Nbility model into archi.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Navigate the UI"
---

# Navigating the user interface
# 5.2.1. Navigating the user interface

1. In Archi, select [**Toggle Collaboration Workspace**] and [**Toggle Branches View**] from the **Collaboration** menu. The Workspace and Branch windows will be docked within Archi. Archi/coArchi supports repository branches.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Refresh model"
---

# Refreshing the model
# 5.2.2. Refreshing the model

**IMPORTANT: To ensure that the local repository remains synchronized with the upstream repository and to prevent overwriting any changes made since the last pull from the server, it is crucial to refresh the model from GitHub before applying any modifications.** Regular refreshs of the model not only maintain alignment with the upstream repository but also mitigate the risk of merge conflicts.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Add new branch"
---

# Adding a new branch
# 5.2.3. Adding a new branch

To protect the integrity of the main branch and avoid overwriting updates from someone else, it is recommended to create a branch for each new piece of work. Branches could be named by feature_[**topic name**] or fix_[**topic name**]. Branches can be created either through the coArchi plugin or via Github.com.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Switch branch"
---

# Switching branches
# 5.2.4. Switching branches

1. In archi, select [**Toggle Branches View**] from the **Collaboration** menu.
2. In archi, right click on the branch you like to switch to and click on [**Switch branch**].
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Commit and publish changes"
---

# Committing and publishing changes
# 5.2.5. Committing and publishing changes

1. To commit your latest changes, select [**Commit changes**] from the **Collaboration** menu.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Merge change"
---

# Creating a pull request review and merging topic branch
# 5.2.6. Creating a pull request review and merging topic branch

On regular intervals all committed and published branches need to be merged into the main branch which will trickle down into all subsequent branches.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Export to XML"
---

# Exporting a model to an Open Exchange XML file
# 5.2.7. Exporting a model to an Open Exchange XML file

1. Open Archi on your local machine and select the architecture repository which you would like to export. For the purpose of this example, we choose Nbility-business-capabilities-EN. See image below.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Export to CSV"
---

# Exporting a model to an Open Exchange CSV file
# 5.2.8. Exporting a model to an Open Exchange CSV file

1. Open Archi on your local machine and select the architecture repository which you would like to export. For the purpose of this example, we choose Nbility-business-capabilities-EN. See image below.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Generate model in PDF, Word, Powerpoint"
---

# Generating a model in PDF, MS Word or MS Powerpoint
# 5.2.9. Generating a model in PDF, MS Word or MS Powerpoint

1. In archi, select [Report] and then [Jasper] in the File menu.

Expand Down
File renamed without changes.
2 changes: 1 addition & 1 deletion docs/CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Code of Conduct
# 2. Code of Conduct

<!--
SPDX-FileCopyrightText: 2014 Coraline Ada Ehmke
Expand Down
2 changes: 1 addition & 1 deletion docs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Contributing to NBility-Model
# 1. Contributing to NBility-Model

Thank you for considering contributing to the NBility-Model project! We appreciate your interest and look forward to your contributions. Follow the guidelines below to ensure a smooth and collaborative experience.

Expand Down
2 changes: 1 addition & 1 deletion docs/GUIDELINES.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# NBility model design guidelines
# 3. NBility model design guidelines

NBility model adheres to generic design rules. Every adjustment and/or expansion should conform to these rules. These guidelines consist of:

Expand Down
2 changes: 1 addition & 1 deletion docs/PROJECT_GOVERNANCE.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Project Governance
# 4. Project Governance

The basic principle is that decisions are based on consensus. If this decision making process takes too long or a decision is required, the project committee has the authority to make a decision.

Expand Down
2 changes: 1 addition & 1 deletion docs/SUPPORT.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Getting Help
# 6. Getting Help

There are a few ways to connect with the `<YOUR_PROJECT_NAME>` project:

Expand Down

0 comments on commit 05f35ed

Please sign in to comment.