Skip to content

Commit 8b4ed19

Browse files
committed
Add docs for luna
1 parent 1108549 commit 8b4ed19

File tree

98 files changed

+9640
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

98 files changed

+9640
-0
lines changed

.github/workflows/deploy.yml

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
name: Deploy documentation
2+
3+
on:
4+
# Trigger the workflow every time you push to the `main` branch
5+
# Using a different branch name? Replace `main` with your branch’s name
6+
push:
7+
# Allows you to run this workflow manually from the Actions tab on GitHub.
8+
workflow_dispatch:
9+
10+
jobs:
11+
build:
12+
runs-on: ubuntu-latest
13+
defaults:
14+
run:
15+
working-directory: docs
16+
steps:
17+
- uses: actions/checkout@v4
18+
- name: Install pnpm
19+
uses: pnpm/action-setup@v4
20+
with:
21+
package_json_file: docs/package.json
22+
- name: Use Node.js
23+
uses: actions/setup-node@v4
24+
with:
25+
node-version: 22
26+
cache: "pnpm"
27+
cache-dependency-path: docs/pnpm-lock.yaml
28+
- name: Install dependencies
29+
run: pnpm install
30+
- name: Build
31+
run: pnpm build
32+
- name: Deploy to SFTP
33+
if: github.ref == 'refs/heads/develop'
34+
env:
35+
SFTP_HOST: ${{ secrets.SFTP_HOST }}
36+
SFTP_USERNAME: ${{ secrets.SFTP_USERNAME }}
37+
SFTP_KEY: ${{ secrets.SFTP_KEY }}
38+
SFTP_KNOWN_HOSTS: ${{secrets.SFTP_KNOWN_HOSTS}}
39+
run: |
40+
echo "$SFTP_KEY" > sftp_key
41+
chmod 600 sftp_key
42+
echo "$SFTP_KNOWN_HOSTS" > known_hosts
43+
chmod 600 known_hosts
44+
rsync -avz --delete -e "ssh -i sftp_key -o UserKnownHostsFile=known_hosts" dist/ $SFTP_USERNAME@$SFTP_HOST:/var/www/luna.linwood

.github/workflows/rust.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ jobs:
2424
if: matrix.project == 'cli'
2525
with:
2626
package_json_file: ${{ matrix.project }}/package.json
27+
run_install: true
2728
- name: Build
2829
run: cargo build --verbose
2930
- name: Run tests

CHANGELOG.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Changelog
2+
3+
<!--ENTER CHANGELOG HERE-->

CODE_OF_CONDUCT.md

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
We as members, contributors, and leaders pledge to make participation in our
6+
community a harassment-free experience for everyone, regardless of age, body
7+
size, visible or invisible disability, ethnicity, sex characteristics, gender
8+
identity and expression, level of experience, education, socio-economic status,
9+
nationality, personal appearance, race, religion, or sexual identity
10+
and orientation.
11+
12+
We pledge to act and interact in ways that contribute to an open, welcoming,
13+
diverse, inclusive, and healthy community.
14+
15+
## Our Standards
16+
17+
Examples of behavior that contributes to a positive environment for our
18+
community include:
19+
20+
* Demonstrating empathy and kindness toward other people
21+
* Being respectful of differing opinions, viewpoints, and experiences
22+
* Giving and gracefully accepting constructive feedback
23+
* Accepting responsibility and apologizing to those affected by our mistakes,
24+
and learning from the experience
25+
* Focusing on what is best not just for us as individuals, but for the
26+
overall community
27+
28+
Examples of unacceptable behavior include:
29+
30+
* The use of sexualized language or imagery, and sexual attention or
31+
advances of any kind
32+
* Trolling, insulting or derogatory comments, and personal or political attacks
33+
* Public or private harassment
34+
* Publishing others' private information, such as a physical or email
35+
address, without their explicit permission
36+
* Other conduct which could reasonably be considered inappropriate in a
37+
professional setting
38+
39+
## Enforcement Responsibilities
40+
41+
Community leaders are responsible for clarifying and enforcing our standards of
42+
acceptable behavior and will take appropriate and fair corrective action in
43+
response to any behavior that they deem inappropriate, threatening, offensive,
44+
or harmful.
45+
46+
Community leaders have the right and responsibility to remove, edit, or reject
47+
comments, commits, code, wiki edits, issues, and other contributions that are
48+
not aligned to this Code of Conduct, and will communicate reasons for moderation
49+
decisions when appropriate.
50+
51+
## Scope
52+
53+
This Code of Conduct applies within all community spaces, and also applies when
54+
an individual is officially representing the community in public spaces.
55+
Examples of representing our community include using an official e-mail address,
56+
posting via an official social media account, or acting as an appointed
57+
representative at an online or offline event.
58+
59+
## Enforcement
60+
61+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
62+
reported to the community leaders responsible for enforcement at
63+
64+
All complaints will be reviewed and investigated promptly and fairly.
65+
66+
All community leaders are obligated to respect the privacy and security of the
67+
reporter of any incident.
68+
69+
## Enforcement Guidelines
70+
71+
Community leaders will follow these Community Impact Guidelines in determining
72+
the consequences for any action they deem in violation of this Code of Conduct:
73+
74+
### 1. Correction
75+
76+
**Community Impact**: Use of inappropriate language or other behavior deemed
77+
unprofessional or unwelcome in the community.
78+
79+
**Consequence**: A private, written warning from community leaders, providing
80+
clarity around the nature of the violation and an explanation of why the
81+
behavior was inappropriate. A public apology may be requested.
82+
83+
### 2. Warning
84+
85+
**Community Impact**: A violation through a single incident or series
86+
of actions.
87+
88+
**Consequence**: A warning with consequences for continued behavior. No
89+
interaction with the people involved, including unsolicited interaction with
90+
those enforcing the Code of Conduct, for a specified period of time. This
91+
includes avoiding interactions in community spaces as well as external channels
92+
like social media. Violating these terms may lead to a temporary or
93+
permanent ban.
94+
95+
### 3. Temporary Ban
96+
97+
**Community Impact**: A serious violation of community standards, including
98+
sustained inappropriate behavior.
99+
100+
**Consequence**: A temporary ban from any sort of interaction or public
101+
communication with the community for a specified period of time. No public or
102+
private interaction with the people involved, including unsolicited interaction
103+
with those enforcing the Code of Conduct, is allowed during this period.
104+
Violating these terms may lead to a permanent ban.
105+
106+
### 4. Permanent Ban
107+
108+
**Community Impact**: Demonstrating a pattern of violation of community
109+
standards, including sustained inappropriate behavior, harassment of an
110+
individual, or aggression toward or disparagement of classes of individuals.
111+
112+
**Consequence**: A permanent ban from any sort of public interaction within
113+
the community.
114+
115+
## Attribution
116+
117+
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118+
version 2.0, available at
119+
https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
120+
121+
Community Impact Guidelines were inspired by [Mozilla's code of conduct
122+
enforcement ladder](https://github.com/mozilla/diversity).
123+
124+
[homepage]: https://www.contributor-covenant.org
125+
126+
For answers to common questions about this code of conduct, see the FAQ at
127+
https://www.contributor-covenant.org/faq. Translations are available at
128+
https://www.contributor-covenant.org/translations.

CONTRIBUTING.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Contribution guide
2+
3+
There are many ways to contribute to this project.
4+
Thanks to everyone who has contributed!
5+
If you have any questions, please contact me at [[email protected]](mailto:[email protected]).
6+
7+
There is a matrix server for this project [here](https://linwood.dev/matrix) and a discord server [here](https://discord.linwood.dev).
8+
9+
Please follow the [Code of Conduct](https://luna.linwood.dev/code-of-conduct).
10+
11+
## Give feedback
12+
13+
The best way to give feedback is to open an issue on GitHub.
14+
Please report any bug you find [here](https://github.com/LinwoodDev/Luna/issues/new?assignees=CodeDoctorDE&labels=bug%2Ctriage&template=bug_report.yml&title=%5BBug%5D%3A+).
15+
16+
If you have a feature that you would like to see added, please open an issue [here](https://github.com/LinwoodDev/Luna/issues/new?assignees=CodeDoctorDE&labels=enhancement%2Ctriage&template=feature_request.yml&title=%5BFeature+request%5D%3A+).
17+
18+
## Test nightly builds
19+
20+
Nightly builds are not production ready and need to be tested.
21+
Please report any bugs in the github issues section.
22+
23+
Read more about it [here](https://luna.linwood.dev/nightly).
24+
25+
## Write documentation
26+
27+
Documentation is important for users to understand the program and its features.
28+
The documentation is written in markdown, a simple markup language. It can be found in the `docs` folder.
29+
30+
To start, please install [pnpm](https://pnpm.io/installation).
31+
32+
Get started by running:
33+
34+
```bash
35+
cd docs
36+
pnpm install
37+
pnpm start
38+
```
39+
40+
All stable documentation can be found in the `versioned_docs` folder.
41+
42+
Fork the project and create a pull request to add your documentation to the `develop` branch.
43+
44+
## Translate
45+
46+
Crowdin is a service that allows you to translate the documentation and the app.
47+
Click [here](https://translate.linwood.dev/luna) to see the project and start translating.
48+
If you have a new language to add, please contact me.
49+
50+
## Code
51+
52+
This project is written in [Dart](https://dart.dev/).
53+
The server source code can be found in the `server` folder.
54+
55+
To get started, run:
56+
57+
```bash
58+
cd app
59+
dart pub get
60+
dart run
61+
```
62+
63+
All subdirectories are documented in the `server/README.md` file.
64+
65+
Fork the project and create a pull request to add your code to the `develop` branch.

0 commit comments

Comments
 (0)