Skip to content

Commit 8971db4

Browse files
Merge pull request #36 from Promptly-Technologies-LLC/33-add-a-github-link-and-promptly-technologies-attribution-in-the-documentation
Added copyright notice and Github icon links to documentation website
2 parents da32bee + edb0643 commit 8971db4

File tree

4 files changed

+37
-23
lines changed

4 files changed

+37
-23
lines changed

README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -164,5 +164,6 @@ and submit a pull request.
164164

165165
### License
166166

167-
This project is licensed under the MIT License. See the LICENSE file for
168-
more details.
167+
This project is created and maintained by [Promptly Technologies,
168+
LLC](https://promptlytechnologies.com/) and licensed under the MIT
169+
License. See the LICENSE file for more details.

_quarto.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,14 @@ website:
2020
text: Deployment
2121
- href: docs/contributing.qmd
2222
text: Contributing
23+
right:
24+
- icon: github
25+
href: https://github.com/promptly-technologies-llc/fastapi-jinja2-postgres-webapp
26+
page-footer:
27+
left: "Copyright 2024, Promptly Technologies, LLC. MIT License."
28+
right:
29+
- icon: github
30+
href: https://github.com/promptly-technologies-llc/fastapi-jinja2-postgres-webapp
2331
format:
2432
html:
2533
theme: cosmo

docs/installation.qmd

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
title: "Installation"
33
---
44

5-
## Install development dependencies in a VSCode Dev Container
5+
## Install all dependencies in a VSCode Dev Container
66

77
If you use VSCode with Docker to develop in a container, the following VSCode Dev Container configuration will install all dependencies:
88

99
``` json
1010
{
1111
"name": "Python 3",
1212
"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
13-
"postCreateCommand": "sudo apt update && sudo apt install -y python3-dev libpq-dev graphviz && pipx install poetry && poetry install && poetry shell",
13+
"postCreateCommand": "sudo apt update && sudo apt install -y python3-dev libpq-dev graphviz && quarto add mcanouil/quarto-iconify && pipx install poetry && poetry install && poetry shell",
1414
"features": {
1515
"ghcr.io/devcontainers/features/docker-outside-of-docker:1": {},
1616
"ghcr.io/rocker-org/devcontainer-features/quarto-cli:1": {}
@@ -45,48 +45,53 @@ For Windows:
4545

4646
- No installation required
4747

48-
### Quarto CLI and Graphviz
48+
### Python dependencies
4949

50-
- [Quarto CLI](https://quarto.org/docs/get-started/)
50+
1. Install Poetry
5151

52+
``` bash
53+
pipx install poetry
54+
```
5255

53-
For macOS:
56+
2. Install project dependencies
5457

5558
``` bash
56-
brew install graphviz
59+
poetry install
5760
```
5861

59-
For Ubuntu/Debian:
62+
3. Activate shell
6063

6164
``` bash
62-
sudo apt update && sudo apt install -y graphviz
65+
poetry shell
6366
```
6467

65-
For Windows:
68+
(Note: You will need to activate the shell every time you open a new terminal session. Alternatively, you can use the `poetry run` prefix before other commands to run them without activating the shell.)
6669

67-
- Download and install from [Graphviz.org](https://graphviz.org/download/#windows)
70+
## Install documentation dependencies manually
6871

69-
### Python dependencies
72+
### Quarto CLI
7073

71-
1. Install Poetry
74+
To render the project documentation, you will need to download and install the [Quarto CLI](https://quarto.org/docs/get-started/) for your operating system.
7275

73-
``` bash
74-
pipx install poetry
75-
```
76+
### Graphviz
7677

77-
2. Install project dependencies
78+
Architecture diagrams in the documentation are rendered with [Graphviz](https://graphviz.org/).
79+
80+
For macOS:
7881

7982
``` bash
80-
poetry install
83+
brew install graphviz
8184
```
8285

83-
3. Activate shell
86+
For Ubuntu/Debian:
8487

8588
``` bash
86-
poetry shell
89+
sudo apt update && sudo apt install -y graphviz
8790
```
8891

89-
(Note: You will need to activate the shell every time you open a new terminal session. Alternatively, you can use the `poetry run` prefix before other commands to run them without activating the shell.)
92+
For Windows:
93+
94+
- Download and install from [Graphviz.org](https://graphviz.org/download/#windows)
9095

9196
## Set environment variables
9297

index.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,4 +133,4 @@ Your contributions are welcome! See the [issues page](https://github.com/promptl
133133

134134
### License
135135

136-
This project is licensed under the MIT License. See the LICENSE file for more details.
136+
This project is created and maintained by [Promptly Technologies, LLC](https://promptlytechnologies.com/) and licensed under the MIT License. See the LICENSE file for more details.

0 commit comments

Comments
 (0)